Microsoft DirectX 9.0

IDirectPlay8NATResolver::EnumDevices Method

Enumerates the list of available devices on which the Network Address Translation (NAT) Resolver can be started.


HRESULT EnumDevices(      

    DPN_SERVICE_PROVIDER_INFO *const pSPInfoBuffer,     PDWORD const pdwBufferSize,     PDWORD const pdwNumDevices,     const DWORD dwFlags );


[out] Pointer to an array of DPN_SERVICE_PROVIDER_INFO structures that will be filled with service provider information.
[out] Pointer to DWORD, which is filled with the size of the pSPInfoBuffer buffer.
Pointer to DWORD which is filled with the number of DPN_SERVICE_PROVIDER_INFO structures returned in pSPInfoBuffer.
[in] Reserved. Set to NULL.

Return Value

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

DPNERR_BUFFERTOOSMALLThe supplied buffer is not large enough to contain the requested data.
DPNERR_INVALIDFLAGSThe flags passed to this method are invalid.
DPNERR_INVALIDOBJECTThe Microsoft?DirectPlay?object pointer is invalid.
DPNERR_INVALIDPARAMOne or more of the parameters passed to the method are invalid.
DPNERR_UNINITIALIZEDThe requested object has not been initialized.


If the value at pdwBufferSize indicates the buffer is too small to hold the list of devices, the size required is placed in pdwBufferSize and DPNERR_BUFFERTOOSMALL is returned. Otherwise the size written is placed in pdwBufferSize

© 2002 Microsoft Corporation. All rights reserved.