Welcome to
www.tdxlibrary.org
Home of the
the TDx_Library...
"RAD DirectX"
for
C++ Builder
...
|
TDx_Play_Library v2.00 Component Reference
|
|
[ TDPSessionDesc::Flags ]
[ next: Instance ]
[ prev: ErrorValue ]
public:
__property dword Flags = { read=FGetFlags, write=FSetFlags, default=0 };
TDPSESSIONDESC::FLAGS
[ component property ]
- Description
The Flags property defines flags indicating the nature of the session.
The described effect applies when the flag is set.
Some of these flags, as noted, may not be modified once the session has been created.
- Flags
DPSESSION_CLIENTSERVER
This is a client/server session hosted by an application server process.
Cannot be modified once the session is created.
Clients joining the session can only enumerate local players and the server player.
The session host will see all the sessions players and can only create a server player.
Incompatible with DPSESSION_MIGRATEHOST.
DPSESSION_DIRECTPLAYPROTOCOL
The session is to use the DirectPlay guaranteed protocol, not the guaranteed protocol implemented by the service provider.
Setting this flag allows message throttling, all TDx_Play::SendEx() functionallity and guaranteed messaging ability, as well as using DirectPlay TCP/IP reliablilty code to improve throughput and delivery.
DPSESSION_JOINDISABLED
No new applications can join the session.
Calls to TDx_Play::Open() with the DPOPEN_JOIN flag and this sessions GUID will fail.
The number of remote players will otherwise be limited by TDPSessiondDesc::MaxPlayers.
DPSESSION_KEEPALIVE
Abnormally disconnected remote players will be detected and deleted from the session.
Cannot be modified once the session is created.
When disconnection was due to a temporary communications problem, the rejoining player will be informed that they have been dropped from the session by a DPMSG_SESSIONLOST message.
A disconnected player will cause the session to be terminated if this flag is not set.
DPSESSION_MIGRATEHOST
Enables another computer to become the host if the current host leaves the session.
Cannot be modified once the session is created.
A DPMSG_HOST system message will be sent to players on the new host.
Incompatible with DPSESSION_CLIENTSERVER, DPSESSION_MULTICASTSERVER and DPSESSION_SECURESERVER.
The session becomes unavailable to new players and computers when the host exits if this flag is not set.
DPSESSION_MULTICASTSERVER
All group and broadcast messages will be routed through the host, which will multicast the message to all recipients.
Cannot be modified once the session is created.
Incompatible with DPSESSION_MIGRATEHOST.
DPSESSION_NEWPLAYERSDISABLED
No new players or applications can can be created or join the session.
TDx_Play::CreatePlayer() will return an error.
The number of remote players will otherwise be limited by TDPSessiondDesc::MaxPlayers.
DPSESSION_NODATAMESSAGES
System messages regarding updates to remote player/group/session data will not be generated.
The methods that generate data messages are TDx_Play::SetPlayerData(), TDx_Play::SetGroupData(), TDx_Play::SetPlayerName(), TDx_Play::SetGroupName() and TDx_Play::SetSessionDesc().
DPMSG_SETSESSIONDESC will also be suppressed.
DPSESSION_NOMESSAGEID
Information indicating the sender and receiver of a message will not be attached to the message.
Cannot be modified once the session is created.
This can reduce message overhead when the id's are not relevent.
DPSESSION_NOPRESERVEORDER
The order in which guaranteed messages are received is irrelevent.
If the order of messages receipt is not important, delays may be reduced by using this flag.
DPSESSION_OPTIMIZELATENCY
Optimises communications for latency, as opposed to bandwidth.
This flag disables TCP/IP nagling.
DPSESSION_PASSWORDREQUIRED
The session requires a password to join.
This read only flag is automatically set when TDPSessionDesc::Password or TDPSessionDesc::PasswordA is not NULL.
DPSESSION_PRIVATE
The session is private and will not be enumerated unless a matching password is provided.
DPSESSION_SECURESERVER
The host of the session is a secure server and credentials must be supplied before it can be opened.
Cannot be modified once the session is created.
Incompatible with DPSESSION_MIGRATEHOST.
- See Also
- Top
If you would like to submit additions or improvements to this page, click: darren_john_dwyer@hotmail.com.
|
|