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
26extern "C" {
27#endif
28
29HRESULT DirectPlayNATHelpCreate(LPCGUID pIID, LPVOID *ppvInterface);
30
31DEFINE_GUID(CLSID_DirectPlayNATHelpUPnP, 0xb9c2e9c4,0x68c1,0x4d42,0xa7,0xa1,0xe7,0x6a,0x26,0x98,0x2a,0xd6);
32DEFINE_GUID(CLSID_DirectPlayNATHelpPAST, 0x963ab779,0x16a1,0x477c,0xa3,0x6d,0xcb,0x5e,0x71,0x19,0x38,0xf7);
33DEFINE_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
92typedef DWORD_PTR DPNHHANDLE;
93typedef DWORD_PTR *PDPNHHANDLE;
94
95typedef 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
106DECLARE_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->ExtendRegisteredPortsLease(p,a,b,c)
187#endif
188
189#ifdef __cplusplus
190}
191#endif
192
193#endif /* __DPNATHLP_H__ */