IDirectPlay8LobbiedApplication Interface

DirectPlay

 
Microsoft DirectX 9.0 SDK Update (Summer 2003)

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 fromIUnknown
Headerdplobby8.h
Minimum operating systems Windows 98, Pocket PC 2002

© 2003 Microsoft Corporation. All rights reserved.