EnumDPCallback

---

Application-defined callback function for the DirectPlayEnumerate function. Depending on whether UNICODE is defined or not, the prototype for the callback function will have lpSPName defined as either the LPWSTR type (for Unicode) or the LPSTR type (for ANSI).

Syntax

BOOL FAR PASCAL EnumDPCallback(
  LPGUID lpguidSP,
  LPSTR/LPWSTR lpSPName,
  DWORD dwMajorVersion,
  DWORD dwMinorVersion,
  LPVOID lpContext
  );

Parameters

lpguidSP

Pointer to the unique identifier of the DirectPlay service provider.

lpSPName

Pointer to a string containing the driver description. Depending on whether the UNICODE symbol is defined or not, the parameter will be of the LPWSTR type (Unicode) or the LPSTR type (ANSI).

dwMajorVersion and dwMinorVersion

Major and minor version numbers of the driver.

lpContext

Pointer to an application-defined context.

Return Value

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

Remarks

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, lpGUIDSP and lpSPName are temporary.

---

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