|Microsoft DirectX 9.0|
Retrieves the remote address information from a remote Microsoft?DirectPlay??Internet Protocol (IP) address.
WCHAR *wszAddress, PDWORD pdwAddressLength, USHORT *psPort );
- [out] Pointer to a buffer to receive the host name. This parameter can be NULL to retrieve the required size.
- [in, out] Size, in characters, of the buffer specified in wszAddress, including the terminating NULL character. On success, this parameter contains the number of characters, including the terminating NULL character, written to the specified buffer. On failure, this parameter contains the number of characters, including the terminating NULL character, required to retrieve the host name.
- [out] Pointer to a USHORT to contain the port specified in this local address.
Returns S_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_INVALIDPARAM One or more of the parameters passed to the method are invalid. DPNERR_INVALIDPOINTER Pointer specified as a parameter is invalid.
To succeed, the contained address must have at least the following elements.
- DPNA_KEY_PORT = specified port