IDirectPlay8AddressIP::BuildLocalAddress

Builds a local DirectPlay 8 IP address from a device and port. The result of a successful call is a valid remote address with the following elements.

• DPNA_KEY_PROVIDER = CLSID_DP8SP_TCPIP
• DPNA_KEY_DEVICE= specified device
• DPNA_KEY_PORT = specified port

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

HRESULT BuildLocalAddress(
const GUID *const pguidAdapter,
const USHORT usPort
);

Parameters

pguidAdapter

[in] Local device identifier to host on.

usPort

[in] Port on the local device to host on. This value can be set to 0 to allow DirectPlay 8.1 to automatically select the port.

Return Values

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

Remarks

Note  The DPNSVR is a DirectPlay feature that allows multiple processes to share a single port for enumeration. Do not use the DPNA_DPNSVR_PORT flag when constructing a device address, or when making a connection. This flag should only be used for enumerations. If you do not add a port element to the enumeration address, the port represented by the flag will be automatically added to that address. See Using the DirectPlay DPNSVR Application for a further discussion of DPNSVR.

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.