Microsoft DirectX 8.0 (Visual Basic)

DPN_APPLICATION_DESC

Describes the settings for a Microsoft® DirectPlay® application.

Type DPN_APPLICATION_DESC
    guidApplication As String
    guidInstance As String
    lCurrentPlayers As Long
    lFlags As Long
    lMaxPlayers As Long
    Password As String
    SessionName As String
End Type

Members

guidApplication
Application GUID.
guidInstance
Globally unique identifier (GUID) that is generated at startup representing the instance of this application. This member is an [out] parameter when calling the GetApplicationDesc method exposed by the DirectPlay8Peer, DirectPlay8Client, and DirectPlay8Server objects. It is an optional [in] parameter when calling the Connect method exposed by the DirectPlay8Peer and DirectPlay8Client objects. It must be set to NULL when you call the SetApplicationDesc method exposed by the DirectPlay8Server and DirectPlay8Peer objects. You can not obtain this GUID by calling the DirectPlay8Server.Host or DirectPlay8Peer.Host methods. You must obtain the GUID by calling a GetApplicationDesc method.
lCurrentPlayers
Number of clients currently connected to the session.
lFlags
One of the following flags describing application behavior.
DPNSESSION_CLIENT_SERVER
Specifies that this type of session is client/server. This flag cannot be combined with DPNSESSION_MIGRATE_HOST.
DPNSESSION_NODPNSVR
Specifies that you do not want enumerations forwarded to your host from DPNSVR. See Using the DirectPlay DPNSVR Application for a further discussion of DPNSVR.
DPNSESSION_REQUIREPASSWORD
Specifies that the session is password protected. If this flag is set, Password must be a valid string.
DPNSESSION_MIGRATE_HOST
Used in peer-to-peer sessions, setting this flag will enable host migration. This flag cannot be combined with DPNSESSION_CLIENT_SERVER.
lMaxPlayers
Maximum number of clients allowed in the session. Set this member to 0 to indicate an unlimited number of players.
Password
String specifying the Unicode™ password that is required to connect to the session. This must be an empty string if the DPNSESSION_REQUIREPASSWORD is not set in the lFlags member.
SessionName
String specifying the Unicode name of the session.

Remarks

The lMaxPlayers, Password, and SessionName members can be set when calling the Host or SetApplicationDesc methods exposed by the DirectPlay8Server and DirectPlay8Peer objects.