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

[in] Pointer to a DirectPlay4 address that will be converted to the DirectPlay 8 address format.

dwDataSize

[in] Size of data contained in the pvAddress parameter.

Return Values

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

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.

• The method cannot map the DPAID_Modem address element because DirectPlay 4 used modem names, while DirectPlay 8 uses GUIDs to identify modems.
• Elements of the DirectPlay 4 address that are not part of the predefined DirectPlay 4 address elements will result in an error and a return value of DPNERR_INVALIDADDRESSFORMAT. See DirectPlay 4 documentation on DirectPlay addresses for a complete list of the DirectPlay 4 address elements.

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.