Welcome to
www.tdxlibrary.org
Home of the
the TDx_Library...
"RAD DirectX"
for
C++ Builder
...
- Description
The Open method will join or create a session.
Secure sessions must be joined using TDx_Play::SecureOpen().
Existing sessions to join can be found using TDx_Play::EnumSessions().
To open more than one session, the application must employ multiple TDx_Play components.
Once joined, messages cannot be exchanged until a local player is created using TDx_Play::CreatePlayer().
Error values that can be generated are:
DPERR_ACCESSDENIED
DPERR_ALREADYINITIALIZED
DPERR_AUTHENTICATIONFAILED
DPERR_CANNOTCREATESERVER
DPERR_CANTCREATEPLAYER
DPERR_CANTLOADCAPI
DPERR_CANTLOADSECURITYPACKAGE
DPERR_CANTLOADSSPI
DPERR_CONNECTING
DPERR_CONNECTIONLOST
DPERR_ENCRYPTIONFAILED
DPERR_ENCRYPTIONNOTSUPPORTED
DPERR_INVALIDFLAGS
DPERR_INVALIDPARAMS
DPERR_INVALIDPASSWORD
DPERR_LOGONDENIED
DPERR_NOCONNECTION
DPERR_NONEWPLAYERS
DPERR_NOSESSIONS
DPERR_SIGNFAILED
DPERR_TIMEOUT
DPERR_UNINITIALIZED
DPERR_USERCANCEL
- Parameters
SD
The SD parameter references a TDPSessionDesc component holding the relevent information about the session to be created or joined.
To join a session only requires the TDPSessionDesc::Instance, and if a password is needed, TDPSessionDesc::Password.
To create a session all the relevent TDPSessionDesc properties must be provided.
The session GUID will be generated by DirectPlay.
Flags
The Flags parameter defines flags indicating the type of open action to be performed.
The described effect applies when the flag is set.
-
DPOPEN_CREATE
A new session instance is to be created.
The local computer will act as the name server and session host for the new session.
DPOPEN_JOIN
An existing session is to be joined.
DPOPEN_RETURNSTATUS
Do not display any connection status dialog boxes.
DDERR_CONNECTING will be returned if the connection cannot be made immediately.
The application should call this method until DP_OK or a different error code is returned.
- See Also
- Top
TDx_Play_Library v2.00 Component Reference
|
|
|
[ TDx_Play::Open() ] [ next: Receive() ] [ prev: Internal_EnumSessionsCallback() ] public:
virtual bool __fastcall Open( TDPSessionDesc* pSD, dword pFlags );
TDX_PLAY::OPEN()
[ component method ]
If you would like to submit additions or improvements to this page, click: darren_john_dwyer@hotmail.com. |
|