Microsoft DirectX 8.0 (C++)

IDirectPlay8Address::BuildFromDPADDRESS

Sets the current object's internal address to be the DirectPlay 8 equivalent of the specified DirectPlay 4 address. The purpose of this method is to allow lobby developers to launch games with the new Microsoft® DirectPlay® interface using the old lobby code.

This method enumerates the address components in the specified address and adds the corresponding element to the DirectPlay 8 address.

HRESULT BuildFromDPADDRESS(
LPVOID pvAddress,
DWORD dwDataSize
);

Parameters

pvAddress
Pointer to a DirectPlay4 address that will be converted to the DirectPlay 8 address format.
dwDataSize
Size of data contained in the pvAddress parameter.

Return Values

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

DPNERR_INVALIDADDRESSFORMAT
DPNERR_INVALIDOBJECT
DPNERR_INVALIDPOINTER

Remarks

This method builds a DirectPlay 8 address from a DirectPlay4 address. This method will clear the current address of all elements before building the new address.

This method has the following limitations.

Requirements

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