Enumerates all the registered service providers and lobby providers that are available to the application. These should be presented to the user to make a selection. The connection that the user selects should be passed to the IDirectPlay3::InitializeConnection method.
HRESULT EnumConnections(
LPCGUID lpguidApplication,
LPDPENUMCONNECTIONSCALLBACK lpEnumCallback,
LPVOID lpContext,
DWORD dwFlags
);
Returns DP_OK if successful, or one of the following error values otherwise:
This method replaces the DirectPlayEnumerate function. DirectPlayEnumerate still works, but only returns registered service providers.
The order in which the service and lobby providers are returned is not guaranteed to be the same in subsequent calls to EnumConnections
Not all the enumerated connections are available for use. For example, this method will return the Modem service provider even if the user has no modem installed. The application can call the IDirectPlay3::InitializeConnection method on each connection and check for an error code to determine if the service provider can be used.
IDirectPlay3::InitializeConnection, EnumConnectionsCallback, DirectPlay Address
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.