Microsoft DirectX 8.1 (C++)

IDirectPlay8LobbiedApplication::SetAppAvailable

Makes an application available or unavailable for a lobby client to connect to. This method is typically called if a lobbied application is independently launched, that is, not launched by a lobby client. Additionally, this method should be called if a game has ended and the lobbied application needs to be available to connect to a lobby client at the start of another game.

HRESULT SetAppAvailable(
const BOOL fAvailable,
const DWORD dwFlags
);

Parameters

fAvailable
[in] Boolean value that sets the availability of the application. Set this value to TRUE to indicate that your application is available, or to FALSE to indicate that it is not available.
dwFlags
[in] The following flag can be set for this method.
DPLAVAILABLE_ALLOWMULTIPLECONNECT
The default behavior for this method is to automatically mark the interface as Unavailable when the first connection is established. By specifying this flag, the interface is not automatically marked unavailable after the first connection is established, thereby allowing multiple connections.

Return Values

Returns S_OK if successful, or one of the following error values.

DPNERR_INVALIDOBJECT
DPNERR_UNINITIALIZED

Requirements

  Windows NT/2000/XP: Available as a redistributable for Windows 2000 and later.
  Windows 98/Me: Available as a redistributable for Windows 98 and later.
  Header: Declared in Dplobby8.h.