Initialisierungs- und Autorisierungseigenschaften

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

OLE DB-Treiber herunterladen

Der OLE DB-Treiber für SQL Server interpretiert Eigenschaften für OLE DB-Initialisierung und -Autorisierung wie folgt:

Eigenschafts-ID BESCHREIBUNG
DBPROP_AUTH_CACHE_AUTHINFO Der OLE DB-Treiber für SQL Server speichert keine Authentifizierungsinformationen im Cache.

Der OLE DB-Treiber für SQL Server gibt bei einem Versuch, den Eigenschaftswert festzulegen, DB_S_ERRORSOCCURRED zurück. Das dwStatus-Element der DBPROP-Struktur gibt DBPROPSTATUS_NOTSUPPORTED an.
DBPROP_AUTH_ENCRYPT_PASSWORD Der OLE DB-Treiber für SQL Server verwendet standardmäßige Microsoft SQL Server-Sicherheitsmechanismen, um Kennwörter zu verbergen.

Der OLE DB-Treiber für SQL Server gibt bei einem Versuch, den Eigenschaftswert festzulegen, DB_S_ERRORSOCCURRED zurück. Das dwStatus-Element der DBPROP-Struktur gibt DBPROPSTATUS_NOTSUPPORTED an.
DBPROP_AUTH_INTEGRATED Wenn DBPROP_AUTH_INTEGRATED auf einen NULL-Zeiger, eine NULL-Zeichenfolge oder einen 'SSPI' VT_BSTR-Wert festgelegt wird, verwendet der OLE DB-Treiber für SQL Server den Windows-Authentifizierungsmodus, um den Benutzerzugriff auf die von den Eigenschaften DBPROP_INIT_DATASOURCE und DBPROP_INIT_CATALOG angegebene SQL Server-Datenbank zu autorisieren.

Wenn die Option auf VT_EMPTY (Standardwert) festgelegt ist, wird SQL Server-Sicherheit verwendet. Die SQL Server-Anmeldung und das Kennwort werden in der DBPROP_AUTH_USERID-und der DBPROP_AUTH_PASSWORD-Eigenschaft angegeben.
DBPROP_AUTH_MASK_PASSWORD Der OLE DB-Treiber für SQL Server verwendet Standard-SQL Server-Sicherheitsmechanismen, um Kennwörter zu verbergen.

Der OLE DB-Treiber für SQL Server gibt bei einem Versuch, den Eigenschaftswert festzulegen, DB_S_ERRORSOCCURRED zurück. Das dwStatus-Element der DBPROP-Struktur gibt DBPROPSTATUS_NOTSUPPORTED an.
DBPROP_AUTH_PASSWORD Einer SQL Server-Anmeldung zugewiesenes Kennwort. Diese Eigenschaft wird verwendet, wenn die SQL Server-Authentifizierung zum Autorisieren des Zugriffs auf eine SQL Server-Datenbank ausgewählt wird.
DBPROP_AUTH_PERSIST_ENCRYPTED Der OLE DB-Treiber für SQL Server verschlüsselt keine Authentifizierungsinformationen, wenn diese persistent sind.

Der OLE DB-Treiber für SQL Server gibt bei einem Versuch, den Eigenschaftswert festzulegen, DB_S_ERRORSOCCURRED zurück. Das dwStatus-Element der DBPROP-Struktur gibt DBPROPSTATUS_NOTSUPPORTED an.
DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO Der OLE DB-Treiber für SQL Server speichert Authentifizierungsinformationen, einschließlich eines Kennwortimages, persistent, wenn dies verlangt wird. Es wird keine Verschlüsselung bereitgestellt.
DBPROP_AUTH_USERID SQL Server-Anmeldename. Diese Eigenschaft wird verwendet, wenn die SQL Server-Authentifizierung zum Autorisieren des Zugriffs auf eine SQL Server-Datenbank ausgewählt wird.
DBPROP_INIT_ASYNCH Der OLE DB-Treiber für SQL Server unterstützt die asynchrone Initialisierung.

Das Festlegen des DBPROPVAL_ASYNCH_INITIALIZE-Bits in der DBPROP_INIT_ASYNCH-Eigenschaft führt dazu, dass IDBInitialize::Initialize ein nicht blockierender Aufruf wird. Weitere Informationen finden Sie unter Ausführen asynchroner Vorgänge.
DBPROP_INIT_CATALOG Name einer vorhandenen SQL Server-Datenbank, zu der eine Verbindung hergestellt werden soll.
DBPROP_INIT_DATASOURCE Netzwerkname eines Servers, auf dem eine Instanz von Microsoft SQL Server ausgeführt wird. Wenn mehrere Instanzen von SQL Server auf dem Computer ausgeführt werden, wird der Wert DBPROP_INIT_DATASOURCE als \\ServerName\InstanceName angegeben, um eine Verbindung mit einer bestimmten Instanz von SQL Server herzustellen. Die Escapesequenz "\\" wird für den umgekehrten Schrägstrich selbst verwendet.
DBPROP_INIT_GENERALTIMEOUT Gibt die Anzahl der Sekunden an, nach der eine Anforderung (außer Datenquelleninitialisierung und Befehlsausführung) wegen des angegebenen Timeouts abgebrochen wird. Der Wert 0 steht für ein unbegrenztes Timeout. Anbieter, die über Netzwerkverbindungen oder in verteilten oder transaktiven Szenarien arbeiten, können diese Eigenschaft für ein Timeout gelisteter Komponenten bei Anforderungen mit langer Ausführungsdauer unterstützen. Timeouts für die Datenquelleninitialisierung und die Befehlsausführung werden weiterhin von DBPROP_INIT_TIMEOUT bzw. DBPROP_COMMANDTIMEOUT gesteuert.

DBPROP_INIT_GENERALTIMEOUT ist schreibgeschützt. Wenn versucht wird, diese Eigenschaft festzulegen, wird der dwstatus-Fehler DBPROPSTATUS_NOTSETTABLE zurückgegeben.
DBPROP_INIT_HWND Das Fensterhandle der aufrufenden Anwendung. Es ist ein gültiges Fensterhandle für das angezeigte Initialisierungsdialogfeld erforderlich, wenn die Aufforderung für Initialisierungseigenschaften zugelassen ist.
DBPROP_INIT_IMPERSONATION_LEVEL Der OLE DB-Treiber für SQL Server unterstützt keine Ebenenanpassung für den Identitätswechsel.

Der OLE DB-Treiber für SQL Server gibt bei einem Versuch, den Eigenschaftswert festzulegen, DB_S_ERRORSOCCURRED zurück. Das dwStatus-Element der DBPROP-Struktur gibt DBPROPSTATUS_NOTSUPPORTED an.
DBPROP_INIT_LCID Der OLE DB-Treiber für SQL Server überprüft die Gebietsschema-ID und gibt einen Fehler zurück, wenn die Gebietsschema-ID nicht unterstützt wird oder auf dem Client nicht installiert ist.
DBPROP_INIT_LOCATION Der OLE DB-Treiber für SQL Server gibt bei einem Versuch, den Eigenschaftswert festzulegen, DB_S_ERRORSOCCURRED zurück. Das dwStatus-Element der DBPROP-Struktur gibt DBPROPSTATUS_NOTSUPPORTED an.
DBPROP_INIT_MODE Der OLE DB-Treiber für SQL Server gibt bei einem Versuch, den Eigenschaftswert festzulegen, DB_S_ERRORSOCCURRED zurück. Das dwStatus-Element der DBPROP-Struktur gibt DBPROPSTATUS_NOTSUPPORTED an.
DBPROP_INIT_PROMPT Der OLE DB-Treiber für SQL Server unterstützt alle Aufforderungsmodi für die Datenquelleninitialisierung. Der OLE DB-Treiber für SQL Server verwendet DBPROMPT_NOPROMPT als Standardeinstellung für diese Eigenschaft.
DBPROP_INIT_PROTECTION_LEVEL Der OLE DB-Treiber für SQL Server unterstützt keine Schutzebene für Verbindungen mit Instanzen von SQL Server.

Der OLE DB-Treiber für SQL Server gibt bei einem Versuch, den Eigenschaftswert festzulegen, DB_S_ERRORSOCCURRED zurück. Das dwStatus-Element der DBPROP-Struktur gibt DBPROPSTATUS_NOTSUPPORTED an.
DBPROP_INIT_PROVIDERSTRING Siehe „OLE DB-Treiber für SQL Server-Zeichenfolge“ weiter unten in diesem Thema.
DBPROP_INIT_TIMEOUT Der OLE DB-Treiber für SQL Server gibt bei der Initialisierung einen Fehler zurück, wenn eine Verbindung mit einer Instanz von SQL Server nicht innerhalb der angegebenen Sekundenzahl hergestellt werden kann.

Im anbieterspezifischen Eigenschaftensatz DBPROPSET_SQLSERVERDBINIT definiert der OLE DB-Treiber für SQL Server diese zusätzlichen Initialisierungseigenschaften.

Eigenschafts-ID BESCHREIBUNG
SSPROP_AUTH_ACCESS_TOKEN1 Typ: VT_BSTR

R/W: Lesen/Schreiben

Standard: VT_EMPTY

Beschreibung: Das Zugriffstoken, das für die Authentifizierung bei der Microsoft Entra-ID verwendet wird.

HINWEIS: Es ist ein Fehler, diese Eigenschaft und die Schlüsselwörter UID, PWD, Trusted_Connection oder Authentication für Verbindungszeichenfolgen oder die entsprechenden Eigenschaften/Schlüsselwörter anzugeben.
SSPROP_AUTH_MODE1 Typ: VT_BSTR

R/W: Lesen/Schreiben

Standard: VT_EMPTY

Beschreibung: Gibt die verwendete SQL- oder Microsoft Entra-Authentifizierung an. Gültige Werte sind:
  • (not set): Der Authentifizierungsmodus wird durch andere Schlüsselwörter bestimmt.
  • (empty string): Hebt einen zuvor festgelegten Authentifizierungsmodus auf.
  • ActiveDirectoryPassword:Benutzernamen- und Kennwortauthentifizierung mit einer Microsoft Entra-Identität.
  • ActiveDirectoryIntegrated: Integrierte Authentifizierung mit einer Microsoft Entra-Identität.

  • HINWEIS: Das Schlüsselwort ActiveDirectoryIntegrated kann auch für die Windows-Authentifizierung gegenüber SQL Server verwendet werden. Es ersetzt die Authentifizierungsschlüsselwörter Integrated Security (oder Trusted_Connection). Es wird empfohlen, dass Anwendungen mit Verwendung der Schlüsselwörter Integrated Security (oder Trusted_Connection) der zugehörigen Eigenschaften den Wert des Schlüsselwerts Authentication (oder der zugehörigen Eigenschaft) auf ActiveDirectoryIntegrated festlegen, um ein neues Verhalten für Verschlüsselung und Zertifikatvalidierung zu aktivieren.

  • ActiveDirectoryInteractive: Interaktive Authentifizierung mit einer Microsoft Entra-Identität. Diese Methode unterstützt die mehrstufige Microsoft Entra-Authentifizierung.
  • ActiveDirectoryMSI:Verwaltete Identitätsauthentifizierung . Für eine benutzerseitig zugewiesene Identität muss die Benutzer-ID auf die Objekt-ID der Benutzeridentität festgelegt werden.
  • ActiveDirectoryServicePrincipal: Dienstprinzipalauthentifizierung mit einer Microsoft Entra-Anwendung. Als Benutzer-ID sollte die ID der Anwendung (des Clients) festgelegt werden. Als Kennwort sollte das Geheimnis der Anwendung (des Clients) festgelegt werden.
  • SqlPassword: Authentifizierung über eine Benutzer-ID und ein Kennwort.

  • HINWEIS: Es wird empfohlen, dass Anwendungen mit Verwendung des Authentifizierungssatzes SQL Server den Wert des Schlüsselwerts Authentication (oder der zugehörigen Eigenschaft) auf SqlPassword festlegen, um ein neues Verhalten für Verschlüsselung und Zertifikatvalidierung zu aktivieren.
SSPROP_AUTH_OLD_PASSWORD Typ: VT_BSTR

R/W: Schreiben

Standardwert: VT_EMPTY

Beschreibung: Das aktuelle oder abgelaufene Kennwort. Weitere Informationen finden Sie unter Programmgesteuertes Ändern von Kennwörtern.
SSPROP_INIT_APPNAME Typ: VT_BSTR

R/W: Lesen/Schreiben

Beschreibung: Der Name der Clientanwendung.
SSPROP_INIT_AUTOTRANSLATE Typ: VT_BOOL

R/W: Lesen/Schreiben

Standardwert: VARIANT_TRUE

Beschreibung: OEM/ANSI-Zeichenkonvertierung.

VARIANT_TRUE: Der OLE DB-Treiber für SQL Server übersetzt ANSI-Zeichenfolgen, die zwischen Client und Server gesendet werden, indem er sie über Unicode konvertiert, um so Probleme bei der Zuordnung von Sonderzeichen zwischen den Codeseiten auf Client und Server zu minimieren:

Client-DBTYPE_STR-Daten, die an eine Instanz von SQL Server char-, varchar- oder text-Variablen, -Parametern oder -Spalten gesendet werden, werden mithilfe der Client-ANSI-Codeseite (ANSI Code Page, ACP) von Zeichen in Unicode konvertiert und dann mithilfe der ACP des Servers aus Unicode wieder in Zeichen konvertiert.

SQL Server char-, varchar- oder text-Daten, die an einer Client-DBTYPE_STR-Variable gesendet werden, werden mithilfe der Server-ACP von Zeichen in Unicode und dann mithilfe der Client-ACP von Unicode wieder in Zeichen konvertiert.

Für Versionen 18.6.4 und 19.1 und höher des OLE DB-Treibers gelten die oben genannten Konvertierungen auch für Daten, die zwischen einem CharVal-Element der SSVARIANT-Struktur und einer Instanz von SQL Server sql_variant-Variablen, Parametern oder Spalten übertragen werden.

Diese Konvertierungen werden vom OLE DB-Treiber für SQL Server auf dem Client durchgeführt. Dies erfordert, dass auf dem Client dieselbe ACP verfügbar ist wie auf dem Server.

Diese Einstellungen haben keine Auswirkungen auf die Konvertierungen, die für diese Übertragungen stattfinden:

An char, varchar oder text auf dem Server gesendete Unicode-DBTYPE_WSTR-Clientdaten.

char-, varchar- oder text-Serverdaten, die an eine Unicode-DBTYPE_WSTR-Variable auf dem Client gesendet werden.

ANSI DBTYPE_STR-Clientdaten, die an Unicode-nchar-, nvarchar- oder ntext auf dem Server gesendet werden.

Unicode-char-, varchar- oder text-Serverdaten, die an eine ANSI DBTYPE_STR-Variable auf dem Client gesendet werden.

VARIANT_FALSE: Der OLE DB-Treiber für SQL Server führt keine Zeichenübersetzungen durch.

Der OLE DB-Treiber für SQL Server übersetzt keine Client-ANSI-Zeichen-DBTYPE_STR-Daten, die an char-, varchar- oder text-Variablen, -Parameter oder -Spalten auf dem Server gesendet werden. Es wird keine Übersetzung von char-, varchar- oder text-Daten durchgeführt, die vom Server an DBTYPE_STR-Variablen auf dem Client gesendet werden. Ebenso verschiebt der OLE DB-Treiber der Versionen 18.6.4 und 19.1 und höher keine Daten, die zwischen einem CharVal-Element der SSVARIANT-Struktur und einer Instanz von SQL Server sql_variant-Variablen, Parametern oder Spalten übertragen werden.

Wenn der Client und die Instanz von SQL Server unterschiedliche ACPs verwenden, können Sonderzeichen fehlinterpretiert werden.
SSPROP_INIT_CONNECT_RETRY_COUNT Typ: VT_I4

R/W: Lesen/Schreiben

Standardwert: 1

Beschreibung: Steuert die Anzahl der neuen Verbindungsversuche im Fall eines Verbindungsverlusts. Weitere Informationen finden Sie unter Resilienz bei Verbindungen im Leerlauf.
SSPROP_INIT_CONNECT_RETRY_INTERVAL Typ: VT_I4

R/W: Lesen/Schreiben

Standardwert: 10

Beschreibung: Gibt die Anzahl von Sekunden zwischen jedem wiederholten Verbindungsversuch im Falle eines Verbindungsverlusts an. Weitere Informationen finden Sie unter Resilienz bei Verbindungen im Leerlauf.
SSPROP_INIT_CURRENTLANGUAGE Typ: VT_BSTR

R/W: Lesen/Schreiben

Beschreibung: Ein SQL Server-Sprachname. Identifiziert die für die Auswahl und Formatierung von Systemnachrichten verwendete Sprache. Die Sprache muss auf dem Computer installiert sein, auf dem eine Instanz von SQL Server ausgeführt wird, sonst schlägt die Datenquelleninitialisierung fehl.
SSPROP_INIT_DATATYPECOMPATIBILITY Typ: VT_UI2

R/W: Lesen/Schreiben

Standardwert: 0

Beschreibung: Ermöglicht Datentypkompatibilität zwischen SQL Server- und ActiveX Data Object (ADO)-Anwendungen. Wenn der Standardwert "0" verwendet wird, wird standardmäßig die Datentypverarbeitung verwendet, die der Anbieter verwendet. Wenn der Wert 80 verwendet wird, verwendet die Datentypverarbeitung nur SQL Server 2000 (8.x)-Datentypen. Weitere Informationen finden Sie unter Verwenden von ADO mit dem OLE DB-Treiber für SQL Server.
SSPROP_INIT_DISCOVEREDSERVERSPN Typ: VT_BSTR

R/W: Lesen

Beschreibung: Wird verwendet, um den Server-SPN einer Verbindung abzufragen. (Version 18.6.3 oder höher)
SSPROP_INIT_ENCRYPT1 Typ: VT_BSTR

R/W: Lesen/Schreiben

Standardwert: Mandatory

Beschreibung: Gibt an, ob die Daten verschlüsselt werden, die über das Netzwerk gesendet werden.

Wenn „Protokollverschlüsselung erzwingen“ aktiviert ist, wird immer verschlüsselt, unabhängig von der Einstellung von SSPROP_INIT_ENCRYPT. Wenn es deaktiviert ist und SSPROP_INIT_ENCRYPT auf Mandatory oder Strict festgelegt wird, wird verschlüsselt.

Wenn „Protokollverschlüsselung erzwingen“ deaktiviert ist und SSPROP_INIT_ENCRYPT auf Optional festgelegt wird, wird nicht verschlüsselt. Gültige Werte sind Optional, Mandatory und Strict. Informationen zu 18.x.x-Versionen finden Sie unter Hauptversionsunterschiede für MSOLEDBSQL.
SSPROP_INIT_FAILOVERPARTNER Typ: VT_BSTR

R/W: Lesen/Schreiben

Beschreibung: Gibt den Namen des Failoverpartners für die Datenbankspiegelung an. Es handelt sich um eine Initialisierungseigenschaft, die nur vor der Initialisierung festgelegt werden kann. Nach der Initialisierung gibt sie den ggf. vom primären Server zurückgegebenen Failoverpartner zurück.

Dadurch kann eine intelligente Anwendung den aktuell ermittelten Sicherungsserver im Cache speichern. Dabei sollte jedoch bedacht werden, dass die Informationen nur aktualisiert werden, wenn die Verbindung anfänglich hergestellt bzw. zurückgesetzt wird (im Fall einer Poolkonfiguration). Bei Langzeitverbindungen können die Informationen daher überholt sein.

Nach dem Herstellen der Verbindung kann die Anwendung dieses Attribut abfragen, um die Identität des Failoverpartners festzustellen. Wenn der primäre Server über keinen Failoverpartner verfügt, gibt diese Eigenschaft eine leere Zeichenfolge zurück. Weitere Informationen finden Sie unter Verwenden der Datenbankspiegelung.
SSPROP_INIT_FAILOVERPARTNERSPN Typ: VT_BSTR

R/W: Lesen/Schreiben

Standardwert: VT_EMPTY

Beschreibung: Gibt den SPN für den Failoverpartner an. Eine leere Zeichenfolge bewirkt, dass der OLE DB-Treiber für SQL Server den vorgegebenen, vom Anbieter generierten SPN verwendet.
SSPROP_INIT_FILENAME Typ: VT_BSTR

R/W: Lesen/Schreiben

Beschreibung: Gibt die primäre Datei für eine anfügbare Datenbank an. Diese Datenbank wird angefügt und als Standarddatenbank für die Verbindung verwendet. Sie müssen den Namen der Datenbank als Wert der Initialisierungseigenschaft DBPROP_INIT_CATALOG angeben, um SSPROP_INIT_FILENAME verwenden zu können. Wenn der Datenbankname nicht vorhanden ist, wird nach dem primären Dateinamen, der in SSPROP_INIT_FILENAME angegeben ist, gesucht, und die Datenbank mit dem in DBPROP_INIT_CATALOG angegebenen Namen wird angefügt. Wenn die Datenbank bereits vorher angefügt wurde, fügt SQL Server sie nicht erneut an.
SSPROP_INIT_HOST_NAME_CERTIFICATE Typ: VT_BSTR

R/W: Lesen/Schreiben

Standardwert: VT_EMPTY

Beschreibung: Der Hostname, der beim Überprüfen des TLS/SSL-Zertifikats von SQL Server verwendet werden soll. Wenn die SSPROP_INIT_HOST_NAME_CERTIFICATE-Eigenschaft nicht festgelegt ist, verwendet der Treiber den DBPROP_INIT_DATASOURCE-Eigenschaftswert als Hostnamen, um das SQL Server-TLS/SSL-Zertifikat zu überprüfen.
SSPROP_INIT_MARSCONNECTION Typ: VT_BOOL

R/W: Lesen/Schreiben

Standardwert: VARIANT_FALSE

Beschreibung: Gibt an, ob Multiple Active Result Sets (MARS) für die Verbindung aktiviert sind. Diese Option muss auf den Wert "True" festgelegt werden, bevor eine Verbindung mit der Datenbank hergestellt wird. Weitere Informationen finden Sie unter Verwenden von Multiple Active Result Sets (MARS).
SSPROP_INIT_MULTISUBNETFAILOVER Typ: VT_BOOL

R/W: Lesen/Schreiben

Standardwert: VARIANT_FALSE

Beschreibung: MultiSubnetFailover ermöglicht ein schnelleres Failover für alle Always On-Verfügbarkeitsgruppen und Failoverclusterinstanzen in SQL Server und reduziert die Failoverzeit für einzelne und Multisubnetz-Always On-Topologien erheblich. Während eines Multisubnetzfailovers versucht der Client Verbindungen parallel. Weitere Informationen finden Sie unter OLE DB-Treiber für SQL Server-Unterstützung für Hochverfügbarkeit, Notfallwiederherstellung.
SSPROP_INIT_NETWORKADDRESS Typ: VT_BSTR

R/W: Lesen/Schreiben

Beschreibung: Die Netzwerkadresse des Servers, auf dem eine von der DBPROP_INIT_DATASOURCE-Eigenschaft angegebene Instanz von SQL Server ausgeführt wird.
SSPROP_INIT_NETWORKLIBRARY Typ: VT_BSTR

R/W: Lesen/Schreiben

Beschreibung: Der Name der Netzwerkbibliothek (DLL), die zum Kommunizieren mit einer Instanz von SQL Server verwendet wird. Der Name sollte weder den Pfad noch die DLL-Dateinamenerweiterung enthalten.

Der Standard kann mit dem SQL Server-Clientkonfigurations-Hilfsprogramm angepasst werden.

Hinweis: Diese Eigenschaft unterstützt nur TCP und Named Pipes. Wenn Sie diese Eigenschaft mit einem Präfix verwenden, erhalten Sie ein Doppelpräfix, da die Eigenschaft zur internen Generierung eines Präfix verwendet wird. Dies führt zu einem Fehler.
SSPROP_INIT_PACKETSIZE Typ: VT_I4

R/W: Lesen/Schreiben

Beschreibung: Dies ist die TDS-Paketgröße (Tabular Data Stream) in Bytes. Der Eigenschaftswert für die Paketgröße muss entweder 0 sein oder zwischen 512 und 32.767 liegen. Der Standardwert ist 0. Dies bedeutet, dass die tatsächliche Paketgröße vom Server bestimmt wird.
SSPROP_INIT_SERVER_CERTIFICATE Typ: VT_BSTR

R/W: Lesen/Schreiben

Standardwert: VT_EMPTY

Beschreibung: Gibt den Pfad zu einer Zertifikatdatei an, die mit dem TLS-/SSL-Zertifikat von SQL Server abgeglichen werden soll. Diese Option kann nur verwendet werden, wenn die Strict-Verschlüsselung aktiviert ist. Die akzeptierten Zertifikatformate sind PEM, DER und CER. Wenn angegeben, wird das SQL Server-Zertifikat überprüft, indem festgestellt wird, ob das bereitgestellte Zertifikat eine exakte Übereinstimmung ist.
SSPROP_INIT_SERVERSPN Typ: VT_BSTR

R/W: Lesen/Schreiben

Standardwert: VT_EMPTY

Beschreibung: Gibt den SPN für den Server an. Eine leere Zeichenfolge bewirkt, dass der OLE DB-Treiber für SQL Server den vorgegebenen, vom Anbieter generierten SPN verwendet.
SSPROP_INIT_TAGCOLUMNCOLLATION Typ: VT_BOOL

R/W: Schreiben

Standardwert: VARIANT_FALSE

Beschreibung: Wird während eines Datenbankupdates verwendet, wenn serverseitige Cursor verwendet werden. Diese Eigenschaft markiert die Daten mit Sortierungsinformationen, die vom Server stammen und nicht von der Codeseite des Clients. Derzeit wird diese Eigenschaft nur vom verteilten Abfrageprozess verwendet, da dieser die Sortierung der Zieldaten kennt und korrekt konvertiert.
SSPROP_INIT_TNIR Typ: VT_BOOL

R/W: Lesen/Schreiben

Standardwert: VARIANT_TRUE

Beschreibung: Wenn dem Hostnamen mehrere IP-Adressen zugeordnet sind, wirkt sich TNIR auf die Verbindungssequenz aus, wenn die erste aufgelöste IP-Adresse des Hostnamens nicht reagiert. TNIR interagiert mit MultiSubnetFailover, um verschiedene Verbindungssequenzen bereitzustellen. Weitere Informationen finden Sie unter Verwenden der transparenten Netzwerk-IP-Adressauflösung.
SSPROP_INIT_TRUST_SERVER_CERTIFICATE1 Typ: VT_BOOL

R/W: Lesen/Schreiben

Standardwert: VARIANT_FALSE

Beschreibung: Wird verwendet, um die Serverzertifikatüberprüfung zu aktivieren oder zu deaktivieren. Diese Eigenschaft bietet Lese- und Schreibzugriff. Wenn jedoch versucht wird, sie nach der Herstellung einer Verbindung festzulegen, führt dies zu einem Fehler.

Diese Eigenschaft wird ignoriert, wenn der Client so konfiguriert ist, dass er eine Zertifikatsüberprüfung erfordert. Eine Anwendung kann die Eigenschaft jedoch zusammen mit SSPROP_INIT_ENCRYPT verwenden, um die Verschlüsselung der Verbindung mit dem Server auch dann zu gewährleisten, wenn der Client so konfiguriert ist, dass er keine Verschlüsselung erfordert und kein Zertifikat auf dem Client zur Verfügung steht.

Clientanwendungen können diese Eigenschaft abfragen, nachdem eine Verbindung zur Feststellung der tatsächlich verwendeten Verschlüsselungs- und Validierungseigenschaften geöffnet wurde.

Hinweis: Eine Verschlüsselung ohne Zertifikatüberprüfung bietet einen teilweisen Schutz gegen Paket-Sniffing, nicht jedoch gegen "Man-in-the-Middle"-Angriffe. Es wird dadurch nur ermöglicht, die Anmeldung und die an den Server gesendeten Daten zu verschlüsseln, ohne das Serverzertifikat zu überprüfen.

Weitere Informationen finden Sie unter Verschlüsselung und Zertifikatüberprüfung.
SSPROP_INIT_USEPROCFORPREP Typ: VT_I4

R/W: Lesen/Schreiben

Standardwert: SSPROPVAL_USEPROCFORPREP_ON

Beschreibung: Verwendung der gespeicherte SQL Server-Prozedur. Definiert die Verwendung von temporär gespeicherten SQL Server-Prozeduren zur Unterstützung der ICommandPrepare-Schnittstelle. Diese Eigenschaft war nur sinnvoll, wenn eine Verbindung mit SQL Server 6.5 hergestellt wurde. Für höhere Versionen wird die Eigenschaft ignoriert.

SSPROPVAL_USEPROCFORPREP_OFF: Bei der Befehlsvorbereitung wird keine temporär gespeicherte Prozedur erstellt.

SSPROPVAL_USEPROCFORPREP_ON: Bei der Befehlsvorbereitung wird eine temporär gespeicherte Prozedur erstellt. Die temporär gespeicherten Prozeduren werden gelöscht, wenn die Sitzung freigegeben wird.

SSPROPVAL_USEPROCFORPREP_ON_DROP: Bei der Befehlsvorbereitung wird eine temporär gespeicherte Prozedur erstellt. Die Prozedur wird gelöscht, wenn die Vorbereitung des Befehls mit ICommandPrepare::Unprepare aufgehoben wird, wenn mit ICommandText::SetCommandText ein neuer Befehl für das Befehlsobjekt angegeben wird oder wenn alle Anwendungsverweise auf den Befehl freigegeben werden.
SSPROP_INIT_WSID Typ: VT_BSTR

R/W: Lesen/Schreiben

Beschreibung: Eine Zeichenfolge, die die Arbeitsstation identifiziert.

[1]: Zur Verbesserung der Sicherheit wird das Verschlüsselungs- und Zertifikatvalidierungsverhalten bei Verwendung von Eigenschaften für die Authentifizierungs-/Zugriffstokeninitialisierung oder den entsprechenden Verbindungszeichenfolgen-Schlüsselwörtern geändert. Ausführliche Informationen finden Sie unter Verschlüsselung und Zertifikatüberprüfung.

Im anbieterspezifischen Eigenschaftensatz DBPROPSET_SQLSERVERDATASOURCEINFO definiert der OLE DB-Treiber für SQL Server die zusätzlichen Eigenschaften. Weitere Informationen finden Sie unter Eigenschaften für Datenquelleninformationen.

OLE DB-Treiber für SQL Server-Zeichenfolge

Der OLE DB-Treiber für SQL Server erkennt eine ODBC-ähnliche Syntax in Anbieterzeichenfolgen-Eigenschaftswerten. Die Anbieterzeichenfolgen-Eigenschaft wird als Wert der OLE DB-Initialisierungseigenschaft DBPROP_INIT_PROVIDERSTRING verfügbar gemacht, wenn eine Verbindung zur OLE DB-Datenquelle hergestellt wird. Diese Eigenschaft gibt die OLE DB-Anbieter-spezifischen Verbindungsdaten an, die zur Implementierung einer Verbindung mit der OLE DB-Datenquelle erforderlich sind. Innerhalb der Zeichenfolge werden Elemente mit einem Semikolon begrenzt. Das abschließende Element in der Zeichenfolge muss mit einem Semikolon beendet werden. Jedes Element besteht aus einem Schlüsselwort, einem Gleichheitszeichen und dem bei der Initialisierung übergebenen Wert. Beispiel:

Server=MyServer;UID=MyUserName;  

Mit dem OLE DB-Treiber für SQL Server muss der Consumer nie die Anbieterzeichenfolgen-Eigenschaft verwenden. Der Consumer kann eine beliebige in der Anbieterzeichenfolge reflektierte Initialisierungseigenschaft festlegen, indem er entweder die für OLE DB oder die für den OLE DB-Treiber für SQL Server spezifischen Initialisierungseigenschaften verwendet.

Eine Liste der Schlüsselwörter, die vom OLE DB-Treiber für SQL Server erkannt werden, finden Sie unter Verwenden von Schlüsselwörtern für Verbindungszeichenfolgen mit dem OLE DB-Treiber für SQL Server.

Weitere Informationen

Datenquellenobjekte (OLE DB)