Welcome to
www.tdxlibrary.org
Home of the
the TDx_Library...
"RAD DirectX"
for
C++ Builder
...
- Description
The SecureOpen method will create or join a secure session.
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().
Credentials supplied on system login may suffice, so when first joining a session, supply no credentials.
If DPERR_LOGONDENIED is returned, then collect credentials from the user and try again.
Error values that can be generated are:
DPERR_ACCESSDENIED
DPERR_ALREADYINITIALIZED
DPERR_AUTHENTICATIONFAILED
DPERR_CANNOTCREATESERVER
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_SIGNFAILED
DPERR_TIMEOUT
DPERR_UNINITIALIZED
DPERR_USERCANCEL
- Parameters
SD
The SD parameter references a TDPSessionDesc component holding the relevent information about the secure session to be created or joined.
To join a secure session only requires the TDPSessionDesc::Instance, and if a password is needed, TDPSessionDesc::Password.
To create a secure session all the relevent TDPSessionDesc properties must be provided and the TDPSessionDesc::Flags DPSESSION_SECURESERVER flag set.
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 secure 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 secure session instance 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.
The Security parameter references a TDPSecurityDesc component holding the security package that the new session will use.
Set NULL when joining a session or to create a secure session using the default security (NT lan manager) and cryptoAPI (Microsoft RSA base cryptographic provider) packages being used.
Credentials
The Credentials parameter references a TDPCredentials component holding the logon name, password and domain to be authenticated by the sessions hosting server.
Set NULL if there are no credentials or the session is being created rather than joined.
- See Also
- Top
TDx_Play_Library v2.00 Component Reference
|
|
|
[ TDx_Play::SecureOpen() ] [ next: Send() ] [ prev: ReceiveEx() ] public:
virtual bool __fastcall SecureOpen( TDPSessionDesc* pSD, dword pFlags, TDPSecurityDesc* pSecurity, TDPCredentials* pCredentials );
TDX_PLAY::SECUREOPEN()
[ component method ]
If you would like to submit additions or improvements to this page, click: darren_john_dwyer@hotmail.com. |
|