Microsoft DirectX 9.0

IDirectPlay8AddressIP::BuildAddress Method

Builds a remote Microsoft?DirectPlay??Internet Protocol (IP) address from a host name and a port.


HRESULT BuildAddress(      

    const WCHAR *const wszAddress,     const USHORT usPort );


[in] Remote host address can be a dotted Internet address—for example,—or a valid host name—for example, example.microsoft.com.
[in] Port on the remote host to which to connect.

Return Value

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

DPNERR_INVALIDPARAMOne or more of the parameters passed to the method are invalid.
DPNERR_INVALIDPOINTERPointer specified as a parameter is invalid.
DPNERR_NOTALLOWEDThis function is not allowed on this object.


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

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

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.

© 2002 Microsoft Corporation. All rights reserved.