IDirectPlay8NATResolver::GetAddresses Method

Retrieves the list of IDirectPlay8Address objects on which the Network Address Translation (NAT) Resolver has been started.

Syntax

HRESULT GetAddresses(      
    IDirectPlay8Address **const ppAddresses,
    DWORD *const pdwNumAddresses,
    const DWORD dwFlags
);

Parameters

ppAddresses

[out] Receives an array of IDirectPlay8Address address objects.

pdwNumAddresses

[in] Number of address objects returned in the ppAddresses.

dwFlags

[in] Reserved. Set to NULL.

Return Value

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

DPNERR_BUFFERTOOSMALL	The supplied buffer is not large enough to contain the requested data.
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_NOCONNECTION	No communication link was established.
DPNERR_UNINITIALIZED	The requested object has not been initialized.

Remarks

IDirectPlay8Address::Release must be called on each of the address interface pointers returned by IDirectPlay8NATResolver::GetAddresses when you are finished with the objects.