IDirectPlay8NATResolver::Start Method

Launches the Network Address Translation (NAT) Resolver server using the specified device addresses.

Syntax

HRESULT Start(      
    IDirectPlay8Address **const ppDevices,
    const DWORD dwNumDevices,
    const DWORD dwFlags
);

Parameters

ppDevices

[in] An array of IDirectPlay8Address device address objects. Set to NULL to use all Internet Protocol (IP) devices. See Remarks.

dwNumDevices

[in] Number of device addresses in the ppDevices array.

dwFlags

[in] Reserved. Set to NULL.

Return Value

Returns DPN_OK if successful, or one of the following error values.

DPNERR_INVALIDDEVICEADDRESS	The address for the local computer or adapter is invalid.
DPNERR_INVALIDFLAGS	The flags passed to this method are invalid.
DPNERR_INVALIDOBJECT	The Microsoft® DirectPlay® object pointer is invalid.
DPNERR_INVALIDPARAM	One or more of the parameters passed to the method are invalid.
DPNERR_UNINITIALIZED	The requested object has not been initialized.

Remarks

The ppDevices parameter must contain address objects which have called IDirectPlay8Address::SetSP with the pGuidSP parameter set to CLSID_DP8SP_TCPIP. If IDirectPlay8Address::SetDevice has not been called to set the device globally unique identifier (GUID), all adapters will be used. Only eight addresses can be specified simultaneously.