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.