Microsoft SDK for Java

getConnectionSettings

This method of the DirectPlayLobby Class retrieves all the information needed to start and connect an application. The data returned is the same data that was passed to the runApplication method by the lobby client or set by calling the setConnectionSettings method.

Syntax

public void getConnectionSettings(int applicationId, int[] connectionFlags, DPSessionDesc sessionDesc, _Guid sessionGuid, _Guid applicationGuid, String[] sessionName, String[] password, String[] playerShortName, String[] playerLongName, _Guid guidSP, byte[] addressData, int[] addressSize);

Parameters

applicationId The application identifier.
connectionFlags Indicates how the connection should be made. This can be one of the following:

DPLCONNECTION_CREATESESSION

Creates a new session as described in the session description.

DPLCONNECTION_JOINSESSION

Joins the existing session as described in the session description.

sessionDesc A DPSessionDesc object describing the sessions to be enumerated. Only those sessions that meet the criteria set in this class will be enumerated.
sessionGuid The GUID of the DirectPlay session of interest. This parameter must be set to NULL unless the DPENUMPLAYERS_SESSION flag is specified.
applicationGuid The application GUID.
sessionName The Unicode string containing the name of the session. Use this member only if the IDirectPlay2 interface is in use.
password Unicode string containing the password of the session. Use this member only if the IDirectPlay2 interface is in use.
playerShortName The short name that the player should be created with. This will be the name of the person registered in the lobby. The application can ignore this name.
playerLongName The long name that the player should be created with.
guidSP The GUID of the service provider used to connect to the session.
addressData The information that the service provider needs to connect to a session.
addressSize The address data size (in bytes).

© 1999 Microsoft Corporation. All rights reserved. Terms of use.