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.