Microsoft DirectX 8.1 (C++)

IDirectPlay8AddressIP::BuildFromSockAddr

Builds a remote DirectPlay 8 IP address from a valid SOCKADDR structure. The SOCKADDR structure must specify an IP address. If the address is not in the correct format, DPNERR_INVALIDPARAM is returned.

The result of a successful call is a valid remote address with the following elements.

DPNA_KEY_PROVIDER = CLSID_DP8SP_TCPIP
DPNA_KEY_HOSTNAME = specified host name
DPNA_KEY_PORT = specified port

All addressing information contained in the object before the call is erased.

HRESULT BuildFromSockAddr(
const SOCKADDR *const pSockAddr
);

Parameters

pSockAddr: [in] Valid UDP address specified in SOCKADDR form.

Return Values

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

DPNERR_INVALIDPARAM

DPNERR_INVALIDPOINTER

DPNERR_NOTALLOWED

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.