DirectPlayEnumerate
Enumerates the DirectPlay service providers installed on the system.
This function is obsolete and remains for compatibility with applications written using DirectX 3. It will only enumerate service providers, not DirectPlay Addresses (connections). It is recommended that applications use the IDirectPlay4::EnumConnections method to enumerate all the connections available to the application after creating an IDirectPlay4 interface.
This function will not enumerate service providers that have the Enumerate value in the registry set to zero. For backward compatibility, this function will only return simple service providers registered under the "Service Providers" registry key.
Syntax
HRESULT WINAPI DirectPlayEnumerate(
LPDPENUMDPCALLBACK lpEnumCallback,
LPVOID lpContext
);
Parameters
- lpEnumCallback
- Pointer to a callback function that will be called with a description of each DirectPlay service provider installed in the system. Depending on whether UNICODE is defined or not, the prototype for the callback function will have the service provider name lpSPName defined as a LPWSTR (for Unicode) or LPSTR (for ANSI).
- lpContext
- Pointer to an application-defined structure that will be passed to the callback function each time the function is called.
Return Value
Returns DP_OK if successful, or one of the following error values otherwise:
DPERR_EXCEPTION DPERR_GENERIC DPERR_INVALIDPARAMS DPERR_INVALIDPARAMS is returned if an invalid enumeration callback was supplied.
Remarks
This function will enumerate service providers installed in the system even though the system might not be capable of using those service providers. For example, a TAPI service provider will be part of the enumeration even though the system might not have a modem installed.
See Also
Top of Page
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.