Home | History | Annotate | Download | only in include
      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__ */
    194