GitHub    Download    Forum
Overview
Tutorial
C++ API
General interfaces
Connection
Connection_Create
Connection_Create
Connection_Destroy
Connection_Destroy
Connect
Disconnect
QueryConfiguration
QueryControl
QueryDomain
QuerySchemaEdit
stcConnectionOptions
IInstance
ISystemCallback
Memory
ObjectId
Thread
Data interfaces
Schema interfaces
Configuration interfaces
Callback interfaces
Structures
Error codes
DataAccess interfaces
C# API
WinRT API
DTDL
DADL
Setup

stcConnectionOptions structure

Contains the options for the Connection::Connect function.

Syntax

struct stcConnectionOptions
{
UINT32 ulKeyExchangeOptions;
UINT32 ulAuthenticationOptions;
UINT32 ulLoginOptions;
 
UINT32 ulKeySize;
UINT32 ulKeyMode;
 
CredHandle* pCredentialsNegotiate;
CredHandle* pCredentialsKerberos;
CredHandle* pCredentialsNtlm;
 
SEC_WINNT_AUTH_IDENTITY* pAuthIdentNegotiate;
SEC_WINNT_AUTH_IDENTITY* pAuthIdentKerberos;
SEC_WINNT_AUTH_IDENTITY* pAuthIdentNtlm;
SEC_WINNT_AUTH_IDENTITY* pAuthIdentPlain;
 
const wchar_t* strServerAccountName;
};

Member

ulKeyExchangeOptions
Type: UINT32
Set of flags that specify which key exchange algorithm and options to use. Use the flags defined in KeyExchangeOption.
Value Description
ECDH The Elliptic Curve Diffie-Hellman algorithm.
DH The Diffie-Hellman algorithm.
RSA The RSA algorithm.
SSPI_NEGOTIATE Microsoft Negotiate
SSPI_KERBEROS Microsoft Kerberos
SSPI_NTLM Microsoft NTLM
ulAuthenticationOptions
Type: UINT32
Set of flags that specify which authentication algorithm and options to use. Use the flags defined in AuthenticationOption.
Value Description
ECDSA The Elliptic Curve DSA algorithm.
RSA The RSA algorithm.
ulLoginOptions
Type: UINT32
Set of flags that specify which login algorithm and options to use. Use the flags defined in LoginOption.
Value Description
SSPI_NEGOTIATE Microsoft Negotiate
SSPI_KERBEROS Microsoft Kerberos
SSPI_NTLM Microsoft NTLM
PLAIN Plain text
ulKeySize
Type: UINT32
Length of the key (in bits) used in the AES encryption algorithm. Valid values are 128, 192, 256.
ulKeyMode
Type: UINT32
Flag that specifies which chaining mode to use for the encryption. Use the flags defined in KeyModeOption.
Value Description
CBC Cipher block chaining mode (CBC).
CCM Counter with CBC-MAC mode (CCM).
GCM Galois counter mode (GCM).
pCredentialsNegotiate
Type: CredHandle*
Credentials, used with the Negotiate algorithm. Set to NULL if you want to use the credentials of the user who is currently logged in.
pCredentialsKerberos
Type: CredHandle*
Credentials, used with the Kerberos algorithm. Set to NULL if you want to use the credentials of the user who is currently logged in.
pCredentialsNtlm
Type: CredHandle*
Credentials, used with the NTLM algorithm. Set to NULL if you want to use the credentials of the user who is currently logged in.
pAuthIdentNegotiate
Type: SEC_WINNT_AUTH_IDENTITY*
Data for creating credentials, used with the Negotiate algorithm. Set to NULL if you want to use the credentials of the user who is currently logged in.
pAuthIdentKerberos
Type: SEC_WINNT_AUTH_IDENTITY*
Data for creating credentials, used with the Kerberos algorithm. Set to NULL if you want to use the credentials of the user who is currently logged in.
pAuthIdentNtlm
Type: SEC_WINNT_AUTH_IDENTITY*
Data for creating credentials, used with the NTLM algorithm. Set to NULL if you want to use the credentials of the user who is currently logged in.
pAuthIdentPlain
Type: SEC_WINNT_AUTH_IDENTITY*
Data for creating credentials, used with the plain text login. Set to NULL if you want to use the credentials of the user who is currently logged in.
strServerAccountName
Type: const wchar_t*
SPN to be used with the algorithms. Mainly used for Kerberos.
© 2025 Mobiland AG