af062818b47340eef15700d2f0211576ba3506eevboxsync/*
af062818b47340eef15700d2f0211576ba3506eevboxsync * Copyright (C) 2006 Maarten Lankhorst
af062818b47340eef15700d2f0211576ba3506eevboxsync *
af062818b47340eef15700d2f0211576ba3506eevboxsync * This library is free software; you can redistribute it and/or
af062818b47340eef15700d2f0211576ba3506eevboxsync * modify it under the terms of the GNU Lesser General Public
af062818b47340eef15700d2f0211576ba3506eevboxsync * License as published by the Free Software Foundation; either
af062818b47340eef15700d2f0211576ba3506eevboxsync * version 2.1 of the License, or (at your option) any later version.
af062818b47340eef15700d2f0211576ba3506eevboxsync *
af062818b47340eef15700d2f0211576ba3506eevboxsync * This library is distributed in the hope that it will be useful,
af062818b47340eef15700d2f0211576ba3506eevboxsync * but WITHOUT ANY WARRANTY; without even the implied warranty of
af062818b47340eef15700d2f0211576ba3506eevboxsync * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
af062818b47340eef15700d2f0211576ba3506eevboxsync * Lesser General Public License for more details.
af062818b47340eef15700d2f0211576ba3506eevboxsync *
af062818b47340eef15700d2f0211576ba3506eevboxsync * You should have received a copy of the GNU Lesser General Public
af062818b47340eef15700d2f0211576ba3506eevboxsync * License along with this library; if not, write to the Free Software
af062818b47340eef15700d2f0211576ba3506eevboxsync * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
af062818b47340eef15700d2f0211576ba3506eevboxsync */
af062818b47340eef15700d2f0211576ba3506eevboxsync
b955672b950093ff7416d1269dd4d3b69983bd8fvboxsync/*
4b9d6701570cb98fd36e209314239d104ec584d3vboxsync * Oracle LGPL Disclaimer: For the avoidance of doubt, except that if any license choice
4b9d6701570cb98fd36e209314239d104ec584d3vboxsync * other than GPL or LGPL is available it will apply instead, Oracle elects to use only
b955672b950093ff7416d1269dd4d3b69983bd8fvboxsync * the Lesser General Public License version 2.1 (LGPLv2) at this time for any software where
b955672b950093ff7416d1269dd4d3b69983bd8fvboxsync * a choice of LGPL license versions is made available with the language indicating
b955672b950093ff7416d1269dd4d3b69983bd8fvboxsync * that LGPLv2 or any later version may be used, or where a choice of which version
b955672b950093ff7416d1269dd4d3b69983bd8fvboxsync * of the LGPL is applied is otherwise unspecified.
b955672b950093ff7416d1269dd4d3b69983bd8fvboxsync */
b955672b950093ff7416d1269dd4d3b69983bd8fvboxsync
af062818b47340eef15700d2f0211576ba3506eevboxsync#ifndef __DPNATHLP_H__
af062818b47340eef15700d2f0211576ba3506eevboxsync#define __DPNATHLP_H__
af062818b47340eef15700d2f0211576ba3506eevboxsync
af062818b47340eef15700d2f0211576ba3506eevboxsync#ifdef __cplusplus
af062818b47340eef15700d2f0211576ba3506eevboxsyncextern "C" {
af062818b47340eef15700d2f0211576ba3506eevboxsync#endif
af062818b47340eef15700d2f0211576ba3506eevboxsync
af062818b47340eef15700d2f0211576ba3506eevboxsyncHRESULT DirectPlayNATHelpCreate(LPCGUID pIID, LPVOID *ppvInterface);
af062818b47340eef15700d2f0211576ba3506eevboxsync
af062818b47340eef15700d2f0211576ba3506eevboxsyncDEFINE_GUID(CLSID_DirectPlayNATHelpUPnP, 0xb9c2e9c4,0x68c1,0x4d42,0xa7,0xa1,0xe7,0x6a,0x26,0x98,0x2a,0xd6);
af062818b47340eef15700d2f0211576ba3506eevboxsyncDEFINE_GUID(CLSID_DirectPlayNATHelpPAST, 0x963ab779,0x16a1,0x477c,0xa3,0x6d,0xcb,0x5e,0x71,0x19,0x38,0xf7);
af062818b47340eef15700d2f0211576ba3506eevboxsyncDEFINE_GUID(IID_IDirectPlayNATHelp, 0x154940b6,0x2278,0x4a2f,0x91,0x01,0x9b,0xa9,0xf4,0x31,0xf6,0x03);
af062818b47340eef15700d2f0211576ba3506eevboxsync
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHGETCAPS_UPDATESERVERSTATUS 0x01
af062818b47340eef15700d2f0211576ba3506eevboxsync
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHREGISTERPORTS_TCP 0x01
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHREGISTERPORTS_FIXEDPORTS 0x02
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHREGISTERPORTS_SHAREDPORTS 0x04
af062818b47340eef15700d2f0211576ba3506eevboxsync
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHADDRESSTYPE_TCP 0x01
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHADDRESSTYPE_FIXEDPORTS 0x02
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHADDRESSTYPE_SHAREDPORTS 0x04
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHADDRESSTYPE_LOCALFIREWALL 0x08
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHADDRESSTYPE_GATEWAY 0x10
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHADDRESSTYPE_GATEWAYISLOCAL 0x20
af062818b47340eef15700d2f0211576ba3506eevboxsync
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHCAPSFLAG_LOCALFIREWALLPRESENT 0x01
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHCAPSFLAG_GATEWAYPRESENT 0x02
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHCAPSFLAG_GATEWAYISLOCAL 0x04
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHCAPSFLAG_PUBLICADDRESSAVAILABLE 0x08
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHCAPSFLAG_NOTALLSUPPORTACTIVENOTIFY 0x10
af062818b47340eef15700d2f0211576ba3506eevboxsync
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHINITIALIZE_DISABLEGATEWAYSUPPORT 0x01
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHINITIALIZE_DISABLELOCALFIREWALLSUPPORT 0x02
af062818b47340eef15700d2f0211576ba3506eevboxsync
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHQUERYADDRESS_TCP 0x01
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHQUERYADDRESS_CACHEFOUND 0x02
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHQUERYADDRESS_CACHENOTFOUND 0x04
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHQUERYADDRESS_CHECKFORPRIVATEBUTUNMAPPED 0x08
af062818b47340eef15700d2f0211576ba3506eevboxsync
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHGETREGISTEREDADDRESSES_LOCALFIREWALLREMAPONLY 0x01
af062818b47340eef15700d2f0211576ba3506eevboxsync
af062818b47340eef15700d2f0211576ba3506eevboxsync#define _DPNH_FACILITY_CODE 0x015
af062818b47340eef15700d2f0211576ba3506eevboxsync#define _DPNH_HRESULT_BASE 0xF000
af062818b47340eef15700d2f0211576ba3506eevboxsync
af062818b47340eef15700d2f0211576ba3506eevboxsync#define MAKE_DPNHSUCCESS(code) \
af062818b47340eef15700d2f0211576ba3506eevboxsync MAKE_HRESULT(0, _DPNH_FACILITY_CODE, (code + _DPNH_HRESULT_BASE))
af062818b47340eef15700d2f0211576ba3506eevboxsync#define MAKE_DPNHFAILURE(code) \
af062818b47340eef15700d2f0211576ba3506eevboxsync MAKE_HRESULT(1, _DPNH_FACILITY_CODE, (code + _DPNH_HRESULT_BASE))
af062818b47340eef15700d2f0211576ba3506eevboxsync
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNH_OK S_OK
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHSUCCESS_ADDRESSESCHANGED MAKE_DPNHSUCCESS(0x10)
af062818b47340eef15700d2f0211576ba3506eevboxsync
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHERR_ALREADYINITIALIZED MAKE_DPNHFAILURE(0x10)
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHERR_BUFFERTOOSMALL MAKE_DPNHFAILURE(0x20)
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHERR_GENERIC E_FAIL
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHERR_INVALIDFLAGS MAKE_DPNHFAILURE(0x30)
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHERR_INVALIDOBJECT MAKE_DPNHFAILURE(0x40)
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHERR_INVALIDPARAM E_INVALIDARG
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHERR_INVALIDPOINTER E_POINTER
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHERR_NOMAPPING MAKE_DPNHFAILURE(0x50)
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHERR_NOMAPPINGBUTPRIVATE MAKE_DPNHFAILURE(0x60)
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHERR_NOTINITIALIZED MAKE_DPNHFAILURE(0x70)
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHERR_OUTOFMEMORY E_OUTOFMEMORY
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHERR_PORTALREADYREGISTERED MAKE_DPNHFAILURE(0x80)
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHERR_PORTUNAVAILABLE MAKE_DPNHFAILURE(0x90)
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHERR_REENTRANT MAKE_DPNHFAILURE(0x95)
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHERR_SERVERNOTAVAILABLE MAKE_DPNHFAILURE(0xA0)
af062818b47340eef15700d2f0211576ba3506eevboxsync#define DPNHERR_UPDATESERVERSTATUS MAKE_DPNHFAILURE(0xC0)
af062818b47340eef15700d2f0211576ba3506eevboxsync
af062818b47340eef15700d2f0211576ba3506eevboxsynctypedef DWORD_PTR DPNHHANDLE;
af062818b47340eef15700d2f0211576ba3506eevboxsynctypedef DWORD_PTR *PDPNHHANDLE;
af062818b47340eef15700d2f0211576ba3506eevboxsync
af062818b47340eef15700d2f0211576ba3506eevboxsynctypedef struct _DPNHCAPS
af062818b47340eef15700d2f0211576ba3506eevboxsync{
af062818b47340eef15700d2f0211576ba3506eevboxsync DWORD dwSize;
af062818b47340eef15700d2f0211576ba3506eevboxsync DWORD dwFlags;
af062818b47340eef15700d2f0211576ba3506eevboxsync DWORD dwNumRegisteredPorts;
af062818b47340eef15700d2f0211576ba3506eevboxsync DWORD dwMinLeaseTimeRemaining;
af062818b47340eef15700d2f0211576ba3506eevboxsync DWORD dwRecommendedGetCapsInterval;
af062818b47340eef15700d2f0211576ba3506eevboxsync} DPNHCAPS, *PDPNHCAPS;
af062818b47340eef15700d2f0211576ba3506eevboxsync
af062818b47340eef15700d2f0211576ba3506eevboxsync
af062818b47340eef15700d2f0211576ba3506eevboxsync#define INTERFACE IDirectPlayNATHelp
af062818b47340eef15700d2f0211576ba3506eevboxsyncDECLARE_INTERFACE_(IDirectPlayNATHelp,IUnknown)
af062818b47340eef15700d2f0211576ba3506eevboxsync{
af062818b47340eef15700d2f0211576ba3506eevboxsync /*** IUnknown methods ***/
af062818b47340eef15700d2f0211576ba3506eevboxsync STDMETHOD(QueryInterface) (THIS_
af062818b47340eef15700d2f0211576ba3506eevboxsync REFIID riid,
af062818b47340eef15700d2f0211576ba3506eevboxsync void** ppvObject) PURE;
af062818b47340eef15700d2f0211576ba3506eevboxsync
af062818b47340eef15700d2f0211576ba3506eevboxsync STDMETHOD_(ULONG,AddRef) (THIS) PURE;
af062818b47340eef15700d2f0211576ba3506eevboxsync
af062818b47340eef15700d2f0211576ba3506eevboxsync STDMETHOD_(ULONG,Release) (THIS) PURE;
af062818b47340eef15700d2f0211576ba3506eevboxsync
af062818b47340eef15700d2f0211576ba3506eevboxsync /*** IDirectPlayNATHelp functions ***/
af062818b47340eef15700d2f0211576ba3506eevboxsync STDMETHOD(Initialize) (THIS_
af062818b47340eef15700d2f0211576ba3506eevboxsync const DWORD dwFlags) PURE;
af062818b47340eef15700d2f0211576ba3506eevboxsync
af062818b47340eef15700d2f0211576ba3506eevboxsync STDMETHOD(Close) (THIS_
af062818b47340eef15700d2f0211576ba3506eevboxsync const DWORD dwFlags) PURE;
af062818b47340eef15700d2f0211576ba3506eevboxsync
af062818b47340eef15700d2f0211576ba3506eevboxsync STDMETHOD(GetCaps) (THIS_
af062818b47340eef15700d2f0211576ba3506eevboxsync const PDPNHCAPS pCaps,
af062818b47340eef15700d2f0211576ba3506eevboxsync const DWORD dwFlags) PURE;
af062818b47340eef15700d2f0211576ba3506eevboxsync
af062818b47340eef15700d2f0211576ba3506eevboxsync STDMETHOD(RegisterPorts) (THIS_
af062818b47340eef15700d2f0211576ba3506eevboxsync const PSOCKADDR aLocalAddresses,
af062818b47340eef15700d2f0211576ba3506eevboxsync const DWORD dwAddressSize,
af062818b47340eef15700d2f0211576ba3506eevboxsync const DWORD dwAddresses,
af062818b47340eef15700d2f0211576ba3506eevboxsync const DWORD dwTime,
af062818b47340eef15700d2f0211576ba3506eevboxsync const PDPNHHANDLE phRegisteredPorts,
af062818b47340eef15700d2f0211576ba3506eevboxsync const DWORD dwFlags) PURE;
af062818b47340eef15700d2f0211576ba3506eevboxsync
af062818b47340eef15700d2f0211576ba3506eevboxsync STDMETHOD(GetRegisteredAddresses) (THIS_
af062818b47340eef15700d2f0211576ba3506eevboxsync const PDPNHHANDLE hRegisteredPorts,
af062818b47340eef15700d2f0211576ba3506eevboxsync const PSOCKADDR paPublicAddresses,
af062818b47340eef15700d2f0211576ba3506eevboxsync const DWORD *dwAddressSize,
af062818b47340eef15700d2f0211576ba3506eevboxsync const DWORD *dwAddressFlags,
af062818b47340eef15700d2f0211576ba3506eevboxsync const DWORD *dwRemaining,
af062818b47340eef15700d2f0211576ba3506eevboxsync const DWORD dwFlags) PURE;
af062818b47340eef15700d2f0211576ba3506eevboxsync
af062818b47340eef15700d2f0211576ba3506eevboxsync STDMETHOD(DeregisterPorts)(THIS_
af062818b47340eef15700d2f0211576ba3506eevboxsync const DPNHHANDLE hRegPorts,
af062818b47340eef15700d2f0211576ba3506eevboxsync const DWORD dwFlags) PURE;
af062818b47340eef15700d2f0211576ba3506eevboxsync
af062818b47340eef15700d2f0211576ba3506eevboxsync STDMETHOD(QueryAddress) (THIS_
af062818b47340eef15700d2f0211576ba3506eevboxsync const PSOCKADDR pSource,
af062818b47340eef15700d2f0211576ba3506eevboxsync const PSOCKADDR pQuery,
af062818b47340eef15700d2f0211576ba3506eevboxsync const PSOCKADDR pResponse,
af062818b47340eef15700d2f0211576ba3506eevboxsync const INT iAddresses,
af062818b47340eef15700d2f0211576ba3506eevboxsync const DWORD dwFlags) PURE;
af062818b47340eef15700d2f0211576ba3506eevboxsync
af062818b47340eef15700d2f0211576ba3506eevboxsync STDMETHOD(SetAlertEvent) (THIS_
af062818b47340eef15700d2f0211576ba3506eevboxsync const HANDLE hEvent,
af062818b47340eef15700d2f0211576ba3506eevboxsync const DWORD dwFlags) PURE;
af062818b47340eef15700d2f0211576ba3506eevboxsync
af062818b47340eef15700d2f0211576ba3506eevboxsync STDMETHOD(SetAlertIOCompletionPort)(THIS_
af062818b47340eef15700d2f0211576ba3506eevboxsync const HANDLE hIOCompletionPort,
af062818b47340eef15700d2f0211576ba3506eevboxsync const DWORD dwCompletion,
af062818b47340eef15700d2f0211576ba3506eevboxsync const DWORD dwMaxThreads,
af062818b47340eef15700d2f0211576ba3506eevboxsync const DWORD dwFlags) PURE;
af062818b47340eef15700d2f0211576ba3506eevboxsync
af062818b47340eef15700d2f0211576ba3506eevboxsync STDMETHOD(ExtendRegisteredPortsLease)(THIS_
af062818b47340eef15700d2f0211576ba3506eevboxsync const DPNHHANDLE hRegisteredPorts,
af062818b47340eef15700d2f0211576ba3506eevboxsync const DWORD dwLeaseTime,
af062818b47340eef15700d2f0211576ba3506eevboxsync const DWORD dwFlags) PURE;
af062818b47340eef15700d2f0211576ba3506eevboxsync};
af062818b47340eef15700d2f0211576ba3506eevboxsync
af062818b47340eef15700d2f0211576ba3506eevboxsync#undef INTERFACE
af062818b47340eef15700d2f0211576ba3506eevboxsync
af062818b47340eef15700d2f0211576ba3506eevboxsync#ifdef COBJMACROS
af062818b47340eef15700d2f0211576ba3506eevboxsync#define IDirectPlayNATHelp_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
af062818b47340eef15700d2f0211576ba3506eevboxsync#define IDirectPlayNATHelp_AddRef(p) (p)->lpVtbl->AddRef(p)
af062818b47340eef15700d2f0211576ba3506eevboxsync#define IDirectPlayNATHelp_Release(p) (p)->lpVtbl->Release(p)
af062818b47340eef15700d2f0211576ba3506eevboxsync#define IDirectPlayNATHelp_Initialize(p,a) (p)->lpVtbl->Initialize(p,a)
af062818b47340eef15700d2f0211576ba3506eevboxsync#define IDirectPlayNATHelp_Close(p,a) (p)->lpVtbl->Close(p,a)
af062818b47340eef15700d2f0211576ba3506eevboxsync#define IDirectPlayNATHelp_GetCaps(p,a,b) (p)->lpVtbl->GetCaps(p,a,b)
af062818b47340eef15700d2f0211576ba3506eevboxsync#define IDirectPlayNATHelp_RegisterPorts(p,a,b,c,d,e,f) (p)->lpVtbl->RegisterPorts(p,a,b,c,d,e,f)
af062818b47340eef15700d2f0211576ba3506eevboxsync#define IDirectPlayNATHelp_GetRegisteredAddresses(p,a,b,c,d,e,f) (p)->lpVtbl->GetRegisteredAddresses(p,a,b,c,d,e,f)
af062818b47340eef15700d2f0211576ba3506eevboxsync#define IDirectPlayNATHelp_DeregisterPorts(p,a,b) (p)->lpVtbl->DeregisterPorts(p,a,b)
af062818b47340eef15700d2f0211576ba3506eevboxsync#define IDirectPlayNATHelp_QueryAddress(p,a,b,c,d,e) (p)->lpVtbl->QueryAddress(p,a,b,c,d,e)
af062818b47340eef15700d2f0211576ba3506eevboxsync#define IDirectPlayNATHelp_SetAlertEvent(p,a,b) (p)->lpVtbl->SetAlertEvent(p,a,b)
af062818b47340eef15700d2f0211576ba3506eevboxsync#define IDirectPlayNATHelp_SetAlertIOCompletionPort(p,a,b,c,d) (p)->lpVtbl->SetAlertIOCompletionPort(p,a,b,c,d)
af062818b47340eef15700d2f0211576ba3506eevboxsync#define IDirectPlayNATHelp_ExtendRegisteredPortsLease(p,a,b,c) (p)->lpVtbl->SetAlertIOCompletionPort(p,a,b,c)
af062818b47340eef15700d2f0211576ba3506eevboxsync#endif
af062818b47340eef15700d2f0211576ba3506eevboxsync
af062818b47340eef15700d2f0211576ba3506eevboxsync#ifdef __cplusplus
af062818b47340eef15700d2f0211576ba3506eevboxsync}
af062818b47340eef15700d2f0211576ba3506eevboxsync#endif
af062818b47340eef15700d2f0211576ba3506eevboxsync
af062818b47340eef15700d2f0211576ba3506eevboxsync#endif /* __DPNATHLP_H__ */