Welcome to
www.tdxlibrary.org
Home of the
the TDx_Library...
"RAD DirectX"
for
C++ Builder
...
- Description
The SetPlayerData method will associate application specific data with the specified player.
There are two types of player data, local and remote. Local data is only available to the local computer, while remote data is propogated to all applications in the session via a DPMSG_SETPLAYERORGROUPDATA message.
Only the computer that created the player may modify its data.
To update real time information, TDx_Play::Send() or TDx_Play::SendEx() should be used, this method is more appropriate for sharing information that does not change rapidly.
Error values that can be generated are:
DPERR_ACCESSDENIED
DPERR_CONNECTIONLOST
DPERR_INVALIDFLAGS
DPERR_INVALIDOBJECT
DPERR_INVALIDPARAMS
DPERR_INVALIDPLAYER
- Parameters
Player
The Group parameter identifies the player with which the data is to be associated.
Data
The Data parameter references the data to be associated with the specified Player.
Set NULL to clear any data already associated with the specified Player.
DataSize
The DataSize parameter defines the size of the Data buffer.
When Data is NULL, this parameter must be zero.
Flags
The Flags parameter defines flags indicating how to propagate the data.
The described effect applies when the flag is set.
The default value of zero will result in remote data being propagated with non-guaranteed messaging.
-
DPSET_GUARANTEED
The remote data is to be propagated with guaranteed messaging.
DPSET_REMOTE must also be set.
DPSET_LOCAL
The data is to be used locally and will not be propagated.
DPSET_REMOTE
The data will be propagated to all the applications in the session.
- See Also
- Top
TDx_Play_Library v2.00 Component Reference
|
|
|
[ TDx_Play::SetPlayerData() ] [ next: SetPlayerName() ] [ prev: SetGroupOwner() ] public:
virtual bool __fastcall SetPlayerData( DPID pPlayer, void* pData, dword pDataSize, dword pFlags );
TDX_PLAY::SETPLAYERDATA()
[ component method ]
If you would like to submit additions or improvements to this page, click: darren_john_dwyer@hotmail.com. |
|