Microsoft DirectX 8.1 (C++)

IDirectPlay8AddressIP::GetAddress

Retrieves the remote address information from a remote DirectPlay 8 IP address. To succeed, the contained address must have at least the following elements.

DPNA_KEY_PROVIDER
DPNA_KEY_HOSTNAME
DPNA_KEY_PORT = specified port

HRESULT GetAddress(
WCHAR* wszAddress,
PDWORD pdwAddressLength,
USHORT* psPort 
);

Parameters

wszAddress: [out] Pointer to a buffer to receive the host name. This parameter can be NULL to retrieve the required size.
pdwAddressLength: [in,out] Size, in characters, of the buffer specified in wszAddress, including NULL terminator. On success, this parameter contains the number of characters, including NULL terminator, written to the specified buffer. On failure, this parameter contains the number of characters, including NULL terminator, required to retrieve the host name.
psPort: [out] Pointer to a USHORT to contain the port specified in this local address.

Return Values

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

DPNERR_BUFFERTOOSMALL

DPNERR_INVALIDPARAM

DPNERR_INVALIDPOINTER

Requirements

  Windows NT/2000/XP: Available as a redistributable for Windows 2000 and later.
  Windows 98/Me: Available as a redistributable for Windows 98 and later.
  Header: Declared in Dpaddr.h.