##

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 IDirectPlay3::EnumConnections method to enumerate all the connections available to the application after creating an IDirectPlay3 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.

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 Values

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

IDirectPlay3::EnumConnections, DirectPlayCreate

© 1997 Microsoft Corporation. All rights reserved. Terms of Use.