IDirectPlayLobby3::CreateCompoundAddress
IDirectPlayLobby3 Interface
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. For a list of predefined Microsoft data types, see DirectPlay Address Data Types.
Syntax
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.
- lpData
- 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.
- lpdwDataSize
- Pointer to a DWORD with the size of the lpData 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 Value
Returns DP_OK if successful, or one of the following error values otherwise:
DPERR_BUFFERTOOSMALL DPERR_INVALIDFLAGS DPERR_INVALIDPARAMS
See Also
IDirectPlayLobby3::CreateAddress, IDirectPlayLobby3::EnumAddress, DPCOMPOUNDADDRESSELEMENT
Top of Page
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.