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
w
char
_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