Microsoft DirectX 9.0

IDirectPlay8Server::GetClientAddress Method

Retrieves the address for the specified player in the session.


HRESULT GetClientAddress(      

    const DPNID dpnid,     IDirectPlay8Address **const pAddress,     const DWORD dwFlags );


[in] Variable of type DPNID specifying the identification of the player.
[out] Address of a pointer to an IDirectPlay8Address object that specifies the address of the client. You must release this object when you no longer need it.
[in] Reserved. Must be 0.

Return Value

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

DPNERR_INVALIDOBJECTThe Microsoft?DirectPlay?object pointer is invalid.
DPNERR_INVALIDPARAMOne or more of the parameters passed to the method are invalid.
DPNERR_INVALIDPLAYERThe player ID is not recognized as a valid player ID for this game session.
DPNERR_INVALIDPOINTERPointer specified as a parameter is invalid.
DPNERR_UNINITIALIZEDThe requested object has not been initialized.


Use the IDirectPlay8Server::GetLocalHostAddresses method to retrieve addresses that can be used to connect to the session.

© 2002 Microsoft Corporation. All rights reserved.