DirectPlay Animated Header -- EnumAddressCallback DirectPlay Animated Header -- EnumAddressCallback* Microsoft DirectPlay SDK
*Index  *Topic Contents
*Previous Topic: Callback Functions
*Next Topic: EnumAddressTypeCallback


EnumAddressCallback


Application-defined callback function for the IDirectPlayLobby2::EnumAddress method.

BOOL FAR PASCAL EnumAddressCallback(
  REFGUID guidDataType,
  DWORD dwDataSize,
  LPCVOID lpData,
  LPVOID lpContext
  );

Parameters
guidDataType
Pointer to a globally unique identifier (GUID) indicating the type of this data chunk. For example, this parameter might be &DPAID_Phone or &DPAID_INet. (In C++, it is a reference to the GUID.)
dwDataSize
Size, in bytes, of the data chunk.
lpData
Pointer to the constant data.
lpContext
Context passed to the callback function.
Return Values

Returns TRUE to continue the enumeration or FALSE to stop it.

Remarks

The service provider should examine the GUID in the guidDataType parameter and process or store the value specified in lpData. Unrecognized values in guidDataType can be ignored.

Any pointers returned in a callback function are temporary and are valid only in the body of the callback function. If the application needs to save pointer information, it must allocate memory to hold the data, copy the data, and then store the pointer to this new data. In this function, lpData is temporary.

© 1998 Microsoft Corporation. All rights reserved. Terms of Use.

*Top of Page