DirectX SDK

IDirectPlayLobby3::EnumLocalApplications

The IDirectPlayLobby3::EnumLocalApplications method enumerates what applications are registered with DirectPlay.

Calling this method on the IDirectPlayLobby3A (ANSI) interface returns a suitably localized, single-byte character string. No multi-byte characters are used so there are no problems displaying the strings using fonts that do not support multi-byte characters. Calling this method on the IDirectPlayLobby3 (Unicode) interface returns a localized, wide character description. Lobbies that are specifically localized should call this method on the Unicode interface.

HRESULT EnumLocalApplications(
  LPDPENUMLOCALAPPLICATIONSCALLBACK lpEnumLocalAppCallback,
  LPVOID lpContext,
  DWORD dwFlags
);

Parameters

lpEnumLocalAppCallback
Pointer to the EnumLocalApplicationsCallback function that will be called for each enumerated application.
lpContext
Context passed to the callback function.
dwFlags
Reserved; must be 0.

Return Values

Returns DP_OK if successful, or one of the following error values otherwise:

DPERR_GENERIC
DPERR_INVALIDINTERFACE
DPERR_INVALIDOBJECT
DPERR_INVALIDPARAMS
DPERR_OUTOFMEMORY

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 dplobby.h.
  Import Library: Use dplayx.lib.

See Also

DPLAPPINFO