| 1 | #undef INTERFACE | 
 
 
 
 
 | 2 | /* | 
 
 
 
 
 | 3 | * Copyright (C) 2006 Maarten Lankhorst | 
 
 
 
 
 | 4 | * | 
 
 
 
 
 | 5 | * This library is free software; you can redistribute it and/or | 
 
 
 
 
 | 6 | * modify it under the terms of the GNU Lesser General Public | 
 
 
 
 
 | 7 | * License as published by the Free Software Foundation; either | 
 
 
 
 
 | 8 | * version 2.1 of the License, or (at your option) any later version. | 
 
 
 
 
 | 9 | * | 
 
 
 
 
 | 10 | * This library is distributed in the hope that it will be useful, | 
 
 
 
 
 | 11 | * but WITHOUT ANY WARRANTY; without even the implied warranty of | 
 
 
 
 
 | 12 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU | 
 
 
 
 
 | 13 | * Lesser General Public License for more details. | 
 
 
 
 
 | 14 | * | 
 
 
 
 
 | 15 | * You should have received a copy of the GNU Lesser General Public | 
 
 
 
 
 | 16 | * License along with this library; if not, write to the Free Software | 
 
 
 
 
 | 17 | * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA | 
 
 
 
 
 | 18 | */ | 
 
 
 
 
 | 19 |  | 
 
 
 
 
 | 20 | #ifndef __DPNATHLP_H__ | 
 
 
 
 
 | 21 | #define __DPNATHLP_H__ | 
 
 
 
 
 | 22 |  | 
 
 
 
 
 | 23 | #include <ole2.h> | 
 
 
 
 
 | 24 |  | 
 
 
 
 
 | 25 | #ifdef __cplusplus | 
 
 
 
 
 | 26 | extern "C" { | 
 
 
 
 
 | 27 | #endif | 
 
 
 
 
 | 28 |  | 
 
 
 
 
 | 29 | HRESULT DirectPlayNATHelpCreate(LPCGUID pIID, LPVOID *ppvInterface); | 
 
 
 
 
 | 30 |  | 
 
 
 
 
 | 31 | DEFINE_GUID(CLSID_DirectPlayNATHelpUPnP, 0xb9c2e9c4,0x68c1,0x4d42,0xa7,0xa1,0xe7,0x6a,0x26,0x98,0x2a,0xd6); | 
 
 
 
 
 | 32 | DEFINE_GUID(CLSID_DirectPlayNATHelpPAST, 0x963ab779,0x16a1,0x477c,0xa3,0x6d,0xcb,0x5e,0x71,0x19,0x38,0xf7); | 
 
 
 
 
 | 33 | DEFINE_GUID(IID_IDirectPlayNATHelp,      0x154940b6,0x2278,0x4a2f,0x91,0x01,0x9b,0xa9,0xf4,0x31,0xf6,0x03); | 
 
 
 
 
 | 34 |  | 
 
 
 
 
 | 35 | #define DPNHGETCAPS_UPDATESERVERSTATUS  0x01 | 
 
 
 
 
 | 36 |  | 
 
 
 
 
 | 37 | #define DPNHREGISTERPORTS_TCP           0x01 | 
 
 
 
 
 | 38 | #define DPNHREGISTERPORTS_FIXEDPORTS    0x02 | 
 
 
 
 
 | 39 | #define DPNHREGISTERPORTS_SHAREDPORTS   0x04 | 
 
 
 
 
 | 40 |  | 
 
 
 
 
 | 41 | #define DPNHADDRESSTYPE_TCP             0x01 | 
 
 
 
 
 | 42 | #define DPNHADDRESSTYPE_FIXEDPORTS      0x02 | 
 
 
 
 
 | 43 | #define DPNHADDRESSTYPE_SHAREDPORTS     0x04 | 
 
 
 
 
 | 44 | #define DPNHADDRESSTYPE_LOCALFIREWALL   0x08 | 
 
 
 
 
 | 45 | #define DPNHADDRESSTYPE_GATEWAY         0x10 | 
 
 
 
 
 | 46 | #define DPNHADDRESSTYPE_GATEWAYISLOCAL  0x20 | 
 
 
 
 
 | 47 |  | 
 
 
 
 
 | 48 | #define DPNHCAPSFLAG_LOCALFIREWALLPRESENT       0x01 | 
 
 
 
 
 | 49 | #define DPNHCAPSFLAG_GATEWAYPRESENT             0x02 | 
 
 
 
 
 | 50 | #define DPNHCAPSFLAG_GATEWAYISLOCAL             0x04 | 
 
 
 
 
 | 51 | #define DPNHCAPSFLAG_PUBLICADDRESSAVAILABLE     0x08 | 
 
 
 
 
 | 52 | #define DPNHCAPSFLAG_NOTALLSUPPORTACTIVENOTIFY  0x10 | 
 
 
 
 
 | 53 |  | 
 
 
 
 
 | 54 | #define DPNHINITIALIZE_DISABLEGATEWAYSUPPORT        0x01 | 
 
 
 
 
 | 55 | #define DPNHINITIALIZE_DISABLELOCALFIREWALLSUPPORT  0x02 | 
 
 
 
 
 | 56 |  | 
 
 
 
 
 | 57 | #define DPNHQUERYADDRESS_TCP                        0x01 | 
 
 
 
 
 | 58 | #define DPNHQUERYADDRESS_CACHEFOUND                 0x02 | 
 
 
 
 
 | 59 | #define DPNHQUERYADDRESS_CACHENOTFOUND              0x04 | 
 
 
 
 
 | 60 | #define DPNHQUERYADDRESS_CHECKFORPRIVATEBUTUNMAPPED 0x08 | 
 
 
 
 
 | 61 |  | 
 
 
 
 
 | 62 | #define DPNHGETREGISTEREDADDRESSES_LOCALFIREWALLREMAPONLY 0x01 | 
 
 
 
 
 | 63 |  | 
 
 
 
 
 | 64 | #define _DPNH_FACILITY_CODE   0x015 | 
 
 
 
 
 | 65 | #define _DPNH_HRESULT_BASE    0xF000 | 
 
 
 
 
 | 66 |  | 
 
 
 
 
 | 67 | #define MAKE_DPNHSUCCESS(code) \ | 
 
 
 
 
 | 68 | MAKE_HRESULT(0, _DPNH_FACILITY_CODE, (code + _DPNH_HRESULT_BASE)) | 
 
 
 
 
 | 69 | #define MAKE_DPNHFAILURE(code) \ | 
 
 
 
 
 | 70 | MAKE_HRESULT(1, _DPNH_FACILITY_CODE, (code + _DPNH_HRESULT_BASE)) | 
 
 
 
 
 | 71 |  | 
 
 
 
 
 | 72 | #define DPNH_OK                         S_OK | 
 
 
 
 
 | 73 | #define DPNHSUCCESS_ADDRESSESCHANGED    MAKE_DPNHSUCCESS(0x10) | 
 
 
 
 
 | 74 |  | 
 
 
 
 
 | 75 | #define DPNHERR_ALREADYINITIALIZED      MAKE_DPNHFAILURE(0x10) | 
 
 
 
 
 | 76 | #define DPNHERR_BUFFERTOOSMALL          MAKE_DPNHFAILURE(0x20) | 
 
 
 
 
 | 77 | #define DPNHERR_GENERIC                 E_FAIL | 
 
 
 
 
 | 78 | #define DPNHERR_INVALIDFLAGS            MAKE_DPNHFAILURE(0x30) | 
 
 
 
 
 | 79 | #define DPNHERR_INVALIDOBJECT           MAKE_DPNHFAILURE(0x40) | 
 
 
 
 
 | 80 | #define DPNHERR_INVALIDPARAM            E_INVALIDARG | 
 
 
 
 
 | 81 | #define DPNHERR_INVALIDPOINTER          E_POINTER | 
 
 
 
 
 | 82 | #define DPNHERR_NOMAPPING               MAKE_DPNHFAILURE(0x50) | 
 
 
 
 
 | 83 | #define DPNHERR_NOMAPPINGBUTPRIVATE     MAKE_DPNHFAILURE(0x60) | 
 
 
 
 
 | 84 | #define DPNHERR_NOTINITIALIZED          MAKE_DPNHFAILURE(0x70) | 
 
 
 
 
 | 85 | #define DPNHERR_OUTOFMEMORY             E_OUTOFMEMORY | 
 
 
 
 
 | 86 | #define DPNHERR_PORTALREADYREGISTERED   MAKE_DPNHFAILURE(0x80) | 
 
 
 
 
 | 87 | #define DPNHERR_PORTUNAVAILABLE         MAKE_DPNHFAILURE(0x90) | 
 
 
 
 
 | 88 | #define DPNHERR_REENTRANT               MAKE_DPNHFAILURE(0x95) | 
 
 
 
 
 | 89 | #define DPNHERR_SERVERNOTAVAILABLE      MAKE_DPNHFAILURE(0xA0) | 
 
 
 
 
 | 90 | #define DPNHERR_UPDATESERVERSTATUS      MAKE_DPNHFAILURE(0xC0) | 
 
 
 
 
 | 91 |  | 
 
 
 
 
 | 92 | typedef DWORD_PTR DPNHHANDLE; | 
 
 
 
 
 | 93 | typedef DWORD_PTR *PDPNHHANDLE; | 
 
 
 
 
 | 94 |  | 
 
 
 
 
 | 95 | typedef struct _DPNHCAPS | 
 
 
 
 
 | 96 | { | 
 
 
 
 
 | 97 | DWORD dwSize; | 
 
 
 
 
 | 98 | DWORD dwFlags; | 
 
 
 
 
 | 99 | DWORD dwNumRegisteredPorts; | 
 
 
 
 
 | 100 | DWORD dwMinLeaseTimeRemaining; | 
 
 
 
 
 | 101 | DWORD dwRecommendedGetCapsInterval; | 
 
 
 
 
 | 102 | } DPNHCAPS, *PDPNHCAPS; | 
 
 
 
 
 | 103 |  | 
 
 
 
 
 | 104 |  | 
 
 
 
 
 | 105 | #define INTERFACE IDirectPlayNATHelp | 
 
 
 
 
 | 106 | DECLARE_INTERFACE_(IDirectPlayNATHelp,IUnknown) | 
 
 
 
 
 | 107 | { | 
 
 
 
 
 | 108 | /*** IUnknown methods ***/ | 
 
 
 
 
 | 109 | STDMETHOD(QueryInterface) (THIS_ | 
 
 
 
 
 | 110 | REFIID riid, | 
 
 
 
 
 | 111 | void** ppvObject) PURE; | 
 
 
 
 
 | 112 |  | 
 
 
 
 
 | 113 | STDMETHOD_(ULONG,AddRef)  (THIS) PURE; | 
 
 
 
 
 | 114 |  | 
 
 
 
 
 | 115 | STDMETHOD_(ULONG,Release) (THIS) PURE; | 
 
 
 
 
 | 116 |  | 
 
 
 
 
 | 117 | /*** IDirectPlayNATHelp functions ***/ | 
 
 
 
 
 | 118 | STDMETHOD(Initialize)     (THIS_ | 
 
 
 
 
 | 119 | DWORD dwFlags) PURE; | 
 
 
 
 
 | 120 |  | 
 
 
 
 
 | 121 | STDMETHOD(Close)          (THIS_ | 
 
 
 
 
 | 122 | DWORD dwFlags) PURE; | 
 
 
 
 
 | 123 |  | 
 
 
 
 
 | 124 | STDMETHOD(GetCaps)        (THIS_ | 
 
 
 
 
 | 125 | PDPNHCAPS pCaps, | 
 
 
 
 
 | 126 | DWORD dwFlags) PURE; | 
 
 
 
 
 | 127 |  | 
 
 
 
 
 | 128 | STDMETHOD(RegisterPorts)  (THIS_ | 
 
 
 
 
 | 129 | PSOCKADDR aLocalAddresses, | 
 
 
 
 
 | 130 | DWORD dwAddressSize, | 
 
 
 
 
 | 131 | DWORD dwAddresses, | 
 
 
 
 
 | 132 | DWORD dwTime, | 
 
 
 
 
 | 133 | PDPNHHANDLE phRegisteredPorts, | 
 
 
 
 
 | 134 | DWORD dwFlags) PURE; | 
 
 
 
 
 | 135 |  | 
 
 
 
 
 | 136 | STDMETHOD(GetRegisteredAddresses) (THIS_ | 
 
 
 
 
 | 137 | PDPNHHANDLE hRegisteredPorts, | 
 
 
 
 
 | 138 | PSOCKADDR paPublicAddresses, | 
 
 
 
 
 | 139 | const DWORD *dwAddressSize, | 
 
 
 
 
 | 140 | const DWORD *dwAddressFlags, | 
 
 
 
 
 | 141 | const DWORD *dwRemaining, | 
 
 
 
 
 | 142 | DWORD dwFlags) PURE; | 
 
 
 
 
 | 143 |  | 
 
 
 
 
 | 144 | STDMETHOD(DeregisterPorts)(THIS_ | 
 
 
 
 
 | 145 | DPNHHANDLE hRegPorts, | 
 
 
 
 
 | 146 | DWORD dwFlags) PURE; | 
 
 
 
 
 | 147 |  | 
 
 
 
 
 | 148 | STDMETHOD(QueryAddress)   (THIS_ | 
 
 
 
 
 | 149 | PSOCKADDR pSource, | 
 
 
 
 
 | 150 | PSOCKADDR pQuery, | 
 
 
 
 
 | 151 | PSOCKADDR pResponse, | 
 
 
 
 
 | 152 | INT iAddresses, | 
 
 
 
 
 | 153 | DWORD dwFlags) PURE; | 
 
 
 
 
 | 154 |  | 
 
 
 
 
 | 155 | STDMETHOD(SetAlertEvent)  (THIS_ | 
 
 
 
 
 | 156 | HANDLE hEvent, | 
 
 
 
 
 | 157 | DWORD dwFlags) PURE; | 
 
 
 
 
 | 158 |  | 
 
 
 
 
 | 159 | STDMETHOD(SetAlertIOCompletionPort)(THIS_ | 
 
 
 
 
 | 160 | HANDLE hIOCompletionPort, | 
 
 
 
 
 | 161 | DWORD dwCompletion, | 
 
 
 
 
 | 162 | DWORD dwMaxThreads, | 
 
 
 
 
 | 163 | DWORD dwFlags) PURE; | 
 
 
 
 
 | 164 |  | 
 
 
 
 
 | 165 | STDMETHOD(ExtendRegisteredPortsLease)(THIS_ | 
 
 
 
 
 | 166 | DPNHHANDLE hRegisteredPorts, | 
 
 
 
 
 | 167 | DWORD dwLeaseTime, | 
 
 
 
 
 | 168 | DWORD dwFlags) PURE; | 
 
 
 
 
 | 169 | }; | 
 
 
 
 
 | 170 |  | 
 
 
 
 
 | 171 | #undef INTERFACE | 
 
 
 
 
 | 172 |  | 
 
 
 
 
 | 173 | #ifdef COBJMACROS | 
 
 
 
 
 | 174 | #define IDirectPlayNATHelp_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b) | 
 
 
 
 
 | 175 | #define IDirectPlayNATHelp_AddRef(p)  (p)->lpVtbl->AddRef(p) | 
 
 
 
 
 | 176 | #define IDirectPlayNATHelp_Release(p) (p)->lpVtbl->Release(p) | 
 
 
 
 
 | 177 | #define IDirectPlayNATHelp_Initialize(p,a) (p)->lpVtbl->Initialize(p,a) | 
 
 
 
 
 | 178 | #define IDirectPlayNATHelp_Close(p,a) (p)->lpVtbl->Close(p,a) | 
 
 
 
 
 | 179 | #define IDirectPlayNATHelp_GetCaps(p,a,b) (p)->lpVtbl->GetCaps(p,a,b) | 
 
 
 
 
 | 180 | #define IDirectPlayNATHelp_RegisterPorts(p,a,b,c,d,e,f) (p)->lpVtbl->RegisterPorts(p,a,b,c,d,e,f) | 
 
 
 
 
 | 181 | #define IDirectPlayNATHelp_GetRegisteredAddresses(p,a,b,c,d,e,f) (p)->lpVtbl->GetRegisteredAddresses(p,a,b,c,d,e,f) | 
 
 
 
 
 | 182 | #define IDirectPlayNATHelp_DeregisterPorts(p,a,b) (p)->lpVtbl->DeregisterPorts(p,a,b) | 
 
 
 
 
 | 183 | #define IDirectPlayNATHelp_QueryAddress(p,a,b,c,d,e) (p)->lpVtbl->QueryAddress(p,a,b,c,d,e) | 
 
 
 
 
 | 184 | #define IDirectPlayNATHelp_SetAlertEvent(p,a,b) (p)->lpVtbl->SetAlertEvent(p,a,b) | 
 
 
 
 
 | 185 | #define IDirectPlayNATHelp_SetAlertIOCompletionPort(p,a,b,c,d) (p)->lpVtbl->SetAlertIOCompletionPort(p,a,b,c,d) | 
 
 
 
 
 | 186 | #define IDirectPlayNATHelp_ExtendRegisteredPortsLease(p,a,b,c) (p)->lpVtbl->SetAlertIOCompletionPort(p,a,b,c) | 
 
 
 
 
 | 187 | #endif | 
 
 
 
 
 | 188 |  | 
 
 
 
 
 | 189 | #ifdef __cplusplus | 
 
 
 
 
 | 190 | } | 
 
 
 
 
 | 191 | #endif | 
 
 
 
 
 | 192 |  | 
 
 
 
 
 | 193 | #endif /* __DPNATHLP_H__ */ |