IDirectPlayLobby3::CreateCompoundAddress

The IDirectPlayLobby3::CreateCompoundAddress method creates a DirectPlay address from a list of individual data chunks. This method can be used to create longer DirectPlay addresses than IDirectPlayLobby3::CreateAddress allows.

HRESULT CreateCompoundAddress(
  LPDPCOMPOUNDADDRESSELEMENT lpElements,
  DWORD dwElementCount,
  LPVOID lpAddress,
  LPDWORD lpdwAddressSize
);

Parameters

lpElements

Pointer to the first element in an array of DPCOMPOUNDADDRESSELEMENT structures that will be used to generate the DirectPlay address.

dwElementCount

The number of address elements in the array pointed to by the lpElements parameter.

lpAddress

Pointer to a buffer that the complete DirectPlay address is to be written to. Pass NULL if only the required size of the buffer is desired.

lpdwAddressSize

Pointer to a DWORD with the size of the lpAddress buffer. The DWORD will be modified to reflect the actual number of bytes copied into the buffer. If the buffer was too small, it will contain the number of bytes required.

Return Values

Returns DP_OK if successful, or one of the following error values otherwise:

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in dplobby.h.
  Import Library: Use dplayx.lib.

See Also

IDirectPlayLobby3::CreateAddress, IDirectPlayLobby3::EnumAddress, DPCOMPOUNDADDRESSELEMENT, DirectPlay Address