Welcome to
www.tdxlibrary.org
Home of the
the TDx_Library...
"RAD DirectX"
for
C++ Builder
...
- Description
The Send method will send guaranteed or unguaranteed messages to individual or multiple players.
TDx_Play::SendEx() can be used to send messages asynchronously.
System messages will always be sent guaranteed. An encypted or signed message is sent as a system message (DPMSG_SECUREMESSAGE).
There is no message size limit, large messages will be broken into packets. It is reccomended large messages be sent guaranteed, as one lost packet on an unguaranteed message will result in the entire message being discarded.
The largest message sendable using a single packet can be determined by checking the TDCaps::MaxBufferSize value returned by TDx_Play::GetCaps().
Error values that can be generated are:
DPERR_BUSY
DPERR_CONNECTIONLOST
DPERR_INVALIDPARAMS
DPERR_INVALIDPLAYER
DPERR_NOTLOGGEDIN
DPERR_SENDTOOBIG
- Parameters
From
The From parameter identifies the local player sending the message.
To
The To parameter identifies the player or group receiving the message if this method return successfully.
DPID_ALLPLAYERS can be specified to send the message to all players in the session, or DPID_SERVERPLAYER to send a message to the server player of a client server session.
Flags
The Flags parameter defines flags indicating how the message is to be sent.
The described effect applies when the flag is set.
The default value of zero will result in a nonguaranteed message being sent.
-
DPSEND_ENCRYPTED
The message is to be sent encrypted.
Requires both a secure session and DPSEND_GUARANTEED.
DPSEND_GUARANTEED
The message is to be sent using guaranteed delivery if available.
DPSEND_SIGNED
The message is to be sent with a digital signature.
Requires both a secure session and DPSEND_GUARANTEED.
The Data parameter references the message data that is to be sent.
DataSize
The DataSize parameter defines the size, in bytes, of the message data to be sent.
- See Also
- Top
TDx_Play_Library v2.00 Component Reference
|
|
|
[ TDx_Play::Send() ] [ next: SendChatMessage() ] [ prev: SecureOpen() ] public:
virtual bool __fastcall Send( DPID pFrom, DPID pTo, dword pFlags, void* pData, dword pDataSize );
TDX_PLAY::SEND()
[ component method ]
If you would like to submit additions or improvements to this page, click: darren_john_dwyer@hotmail.com. |
|