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.