|Microsoft DirectX 9.0|
Retrieves the address for the specified remote player in the session.
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 peer. You must release this object when you no longer need it.
- [in] Reserved. Must be 0.
Returns S_OK if successful, or one of the following error values.
DPNERR_INVALIDOBJECT The Microsoft?DirectPlay?object pointer is invalid. DPNERR_INVALIDPLAYER The player ID is not recognized as a valid player ID for this game session. DPNERR_INVALIDPARAM One or more of the parameters passed to the method are invalid. DPNERR_INVALIDPOINTER Pointer specified as a parameter is invalid. DPNERR_UNINITIALIZED The requested object has not been initialized.
This method cannot be used to retrieve the address of the local player. If the player calls this method on his or her own identifier (ID), it returns a DPNERR_INVALIDPLAYER error message.
Use IDirectPlay8Peer::GetLocalHostAddresses to retrieve addresses that can be used to connect to the session.