EnumDPCallback

EnumDPCallback is an 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).

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 Values

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.

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 dplay.h.