IDirectPlay8LobbiedApplication Interface

The IDirectPlay8LobbiedApplication interface is used by an application that supports lobbying. This interface allows the application to register with the system so that it can be lobby launched. Additionally, it also lets the application get the connection information necessary to launch a game without querying the user. Lastly, this interface allows the lobbied application to send messages and notifications to the lobby client that launched the application.

IDirectPlay8LobbiedApplication Members

Close
Deletes the lobbied application.
GetConnectionSettings
Retrieves the set of connection settings for the specified connection. These settings can be set through a call to the IDirectPlay8LobbyClient::ConnectApplication, IDirectPlay8LobbyClient::SetConnectionSettings, or IDirectPlay8LobbiedApplication::SetConnectionSettings method.
When you get connection settings, a reference will be added for each address object that is returned to the user. Therefore, users must be sure to call Release on each address object when they are done with the structure.
Initialize
Registers a message handler function that receives notifications about changes in the state of the lobby client and receives messages from the lobby client.
RegisterProgram
Registers a lobby-aware application with Microsoft?DirectPlay? Applications must be registered to enable lobby launching.
Send
Sends a message from the lobbied application to the lobby client.
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.
SetConnectionSettings
Sets the connection settings to be associated with the specified connection. Calling this method generates a DPL_MSGID_CONNECTION_SETTINGS message to be sent to the client specified by hConnection.
When you set connection settings, the lobby application will add a reference to each of the address objects specified in the call.
UnRegisterProgram
Unregisters a lobby-aware application that was registered through the IDirectPlay8LobbiedApplication::RegisterProgram method.
UpdateStatus
Updates the status of a connected lobby client.

Interface Information

Inherits from IUnknown
Header dplobby8.h
Minimum operating systems Windows 98, Pocket PC 2002

Close	Deletes the lobbied application.
GetConnectionSettings	Retrieves the set of connection settings for the specified connection. These settings can be set through a call to the IDirectPlay8LobbyClient::ConnectApplication, IDirectPlay8LobbyClient::SetConnectionSettings, or IDirectPlay8LobbiedApplication::SetConnectionSettings method. When you get connection settings, a reference will be added for each address object that is returned to the user. Therefore, users must be sure to call Release on each address object when they are done with the structure.
Initialize	Registers a message handler function that receives notifications about changes in the state of the lobby client and receives messages from the lobby client.
RegisterProgram	Registers a lobby-aware application with Microsoft?DirectPlay? Applications must be registered to enable lobby launching.
Send	Sends a message from the lobbied application to the lobby client.
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.
SetConnectionSettings	Sets the connection settings to be associated with the specified connection. Calling this method generates a DPL_MSGID_CONNECTION_SETTINGS message to be sent to the client specified by hConnection. When you set connection settings, the lobby application will add a reference to each of the address objects specified in the call.
UnRegisterProgram	Unregisters a lobby-aware application that was registered through the IDirectPlay8LobbiedApplication::RegisterProgram method.
UpdateStatus	Updates the status of a connected lobby client.

Inherits from	IUnknown
Header	dplobby8.h
Minimum operating systems	Windows 98, Pocket PC 2002