Teilen über


Initialisierungs- und Autorisierungseigenschaften

Gilt für:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)SQL-Datenbank in Microsoft Fabric

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 Driver für SQL Server speichert keine Authentifizierungsinformationen.

Der OLE-DB-Treiber für SQL Server gibt bei einem Versuch, den Eigenschaftswert festzulegen, zurück.DB_S_ERRORSOCCURRED Das dwStatus-Mitglied der DBPROP-Struktur gibt .DBPROPSTATUS_NOTSUPPORTED
DBPROP_AUTH_ENCRYPT_PASSWORD Der OLE DB Driver für SQL Server verwendet standardisierte SQL-Server-Sicherheitsmechanismen, um Passwörter zu verbergen.

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

Wenn es auf VT_EMPTY (Standard) gesetzt ist, wird SQL Server Security verwendet. Der SQL-Server-Login und das Passwort sind in den DBPROP_AUTH_USERID Eigenschaften und DBPROP_AUTH_PASSWORD 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, zurück.DB_S_ERRORSOCCURRED Das dwStatus-Mitglied der DBPROP-Struktur gibt .DBPROPSTATUS_NOTSUPPORTED
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-Datenbanktreiber für SQL Server verschlüsselt keine Authentifizierungsinformationen, wenn sie gespeichert werden.

Der OLE-DB-Treiber für SQL Server gibt bei einem Versuch, den Eigenschaftswert festzulegen, zurück.DB_S_ERRORSOCCURRED Das dwStatus-Mitglied der DBPROP-Struktur gibt .DBPROPSTATUS_NOTSUPPORTED
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 Setzen des DBPROPVAL_ASYNCH_INITIALIZE Bits in der Eigenschaft DBPROP_INIT_ASYNCH führt dazu, IDBInitialize::Initialize dass ein blockfreier 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, der eine SQL Server-Instanz ausführt. Wenn mehrere SQL Server-Instanzen auf dem Computer laufen, wird für die Verbindung zu einer bestimmten SQL-Server-Instanz der Wert DBPROP_INIT_DATASOURCE als angegeben \\<ServerName>\<InstanceName>. Die Fluchtsequenz \\ wird für den Backslash selbst verwendet.
DBPROP_INIT_GENERALTIMEOUT Zeigt die Anzahl der Sekunden an, bevor eine Anfrage, abgesehen von der Initialisierung der Datenquelle und der Befehlsausführung, abläuft. Ein Wert von 0 zeigt eine unendliche Auszeit an. Anbieter, die über Netzwerkverbindungen oder in verteilten oder getransakteten Szenarien arbeiten, können diese Eigenschaft unterstützen, um einer Mannschaftskomponente zu raten, bei einer langanhaltenden Anfrage zu timeouten. Timeouts für die Initialisierung der Datenquelle und die Befehlsausführung bleiben jeweils durch DBPROP_INIT_TIMEOUT und DBPROP_COMMANDTIMEOUTbestimmt.

DBPROP_INIT_GENERALTIMEOUT ist nur lesbar, und wenn man versucht, sie zu setzen, wird der dwstatus-Fehler von 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-Datenbanktreiber für SQL Server unterstützt keine Anpassung auf Impersonationsniveau.

Der OLE-DB-Treiber für SQL Server gibt bei einem Versuch, den Eigenschaftswert festzulegen, zurück.DB_S_ERRORSOCCURRED Das dwStatus-Mitglied der DBPROP-Struktur gibt .DBPROPSTATUS_NOTSUPPORTED
DBPROP_INIT_LCID Der OLE DB Driver für SQL Server validiert die Lokalisierungs-ID und gibt einen Fehler zurück, wenn die Lokalisierungs-ID nicht unterstützt wird oder nicht im Client installiert ist.
DBPROP_INIT_LOCATION Der OLE-DB-Treiber für SQL Server gibt bei einem Versuch, den Eigenschaftswert festzulegen, zurück.DB_S_ERRORSOCCURRED Das dwStatus-Mitglied der DBPROP-Struktur gibt .DBPROPSTATUS_NOTSUPPORTED
DBPROP_INIT_MODE Der OLE-DB-Treiber für SQL Server gibt bei einem Versuch, den Eigenschaftswert festzulegen, zurück.DB_S_ERRORSOCCURRED Das dwStatus-Mitglied der DBPROP-Struktur gibt .DBPROPSTATUS_NOTSUPPORTED
DBPROP_INIT_PROMPT Der OLE DB-Treiber für SQL Server unterstützt alle Aufforderungsmodi für die Datenquelleninitialisierung. Der OLE DB Driver für SQL Server verwendet DBPROMPT_NOPROMPT als Standardeinstellung für die Eigenschaft.
DBPROP_INIT_PROTECTION_LEVEL Der OLE DB Driver für SQL Server unterstützt keinen Schutzgrad für Verbindungen zu SQL Server-Instanzen.

Der OLE-DB-Treiber für SQL Server gibt bei einem Versuch, den Eigenschaftswert festzulegen, zurück.DB_S_ERRORSOCCURRED Das dwStatus-Mitglied der DBPROP-Struktur gibt .DBPROPSTATUS_NOTSUPPORTED
DBPROP_INIT_PROVIDERSTRING Siehe später in diesem Artikel den OLE DB Driver für SQL Server-String.
DBPROP_INIT_TIMEOUT Der OLE DB Driver für SQL Server liefert bei der Initialisierung einen Fehler, wenn innerhalb der angegebenen Sekundenlänge keine Verbindung zur SQL Server-Instanz hergestellt werden kann.

Im providerspezifischen Eigenschaftssatz DBPROPSET_SQLSERVERDBINITdefiniert der OLE DB Driver für SQL Server diese zusätzlichen Initialisierungseigenschaften.

Eigenschafts-ID BESCHREIBUNG
SSPROP_AUTH_ACCESS_TOKEN 1 Typ: VT_BSTR

R/W: Lesen/Schreiben

Standard: VT_EMPTY

Beschreibung: Das Zugangstoken, das zur Authentifizierung der Microsoft Entra-ID verwendet wird.

Hinweis: Es ist ein Fehler, diese Eigenschaft sowie UID, PWD, Trusted_Connection, oder Authentication Verbindungsstring-Schlüsselwörter oder deren entsprechende Eigenschaften/Schlüsselwörter anzugeben.
SSPROP_AUTH_MODE 1 Typ: VT_BSTR

R/W: Lesen/Schreiben

Standard: VT_EMPTY

Beschreibung: Spezifiziert die verwendete SQL- oder Microsoft Entra-Authentifizierung. 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 ActiveDirectoryIntegrated Schlüsselwort kann auch für die Windows-Authentifizierung für SQL Server verwendet werden. Es ersetzt die Authentifizierungsschlüsselwörter Integrated Security (oder Trusted_Connection). Anwendungen, Integrated Security die Schlüsselwörter (oder Trusted_Connection) verwenden, oder ihre entsprechenden Eigenschaften sollten den Wert des Authentication Schlüsselworts (oder der entsprechenden Eigenschaft) festlegen, um ActiveDirectoryIntegrated ein neues Verschlüsselungs- und Zertifikatüberprüfungsverhalten zu ermöglichen.

  • ActiveDirectoryInteractive: Interaktive Authentifizierung mit einer Microsoft Entra-Identität. Diese Methode unterstützt die Multi-Faktor-Authentifizierung für Microsoft Entra.
  • 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: Service Principal Authentifizierung 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 mit Benutzer-ID und Kennwort.

  • Hinweis: Anwendungen mit SQL Server-Authentifizierung sollten den Wert des Authentication Schlüsselworts (oder der entsprechenden Eigenschaft) festlegen, um SqlPassworddas neue Verschlüsselungs- und Zertifikatüberprüfungsverhalten zu ermöglichen.
SSPROP_AUTH_OLD_PASSWORD Typ: VT_BSTR

R/W: Schreiben

Standard: VT_EMPTY

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

R/W: Lesen/Schreiben

Beschreibung: Der Name der Client-Anwendung.
SSPROP_INIT_AUTOTRANSLATE Typ: VT_BOOL

R/W: Lesen/Schreiben

Standard: VARIANT_TRUE

Beschreibung: OEM/ANSI-Zeichenumwandlung.

VARIANT_TRUE: Der OLE-Datenbanktreiber für SQL Server übersetzt ANSI-Zeichenzeichenzeichen, die zwischen Client und Server gesendet werden, indem er über Unicode konvertiert, um Probleme bei der Übereinstimmung erweiterter Zeichen zwischen den Codepages des Client und des Servers zu minimieren:

Client-Daten DBTYPE_STR , die an eine Instanz von SQL Server-Zeichen, Varchar oder Textvariable , Parameter oder Spalte gesendet werden, werden vom Zeichen in Unicode mit der Client-ANSI-Codepage (ACP) umgewandelt und anschließend von Unicode zu Zeichen mit dem ACP des Servers umgewandelt.

SQL-Server-Zeichen-, Varchar- oder Textdaten, die an eine Client-Variable DBTYPE_STR gesendet werden, werden vom Zeichen in Unicode mit dem Server-ACP umgewandelt und dann von Unicode zu Zeichen mit dem Client-ACP umgewandelt.

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 dasselbe ACP, das auf dem Server verwendet wird, auch im Client verfügbar ist.

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

Unicode-Client-Daten DBTYPE_WSTR , die an char, varchar oder Text auf dem Server gesendet werden.

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

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

Unicode-Char-, Varchar- oder Textserverdaten, die an eine ANSI-Variable DBTYPE_STR im Client gesendet werden.

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

Der OLE DB Driver für SQL Server übersetzt keine Client-ANSI-Zeichendaten DBTYPE_STR , die auf char, varchar oder Textvariablen , Parameter oder Spalten auf dem Server gesendet werden. Es wird keine Übersetzung von Char-, Varchar- oder Textdaten durchgeführt, die vom Server an DBTYPE_STR Variablen im 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

Standard: 1

Beschreibung: Regelt die Anzahl der Wiederverbindungsversuche im Falle eines Verbindungsverlusts. Weitere Informationen finden Sie unter Idle-Verbindungsresilienz im OLE DB-Treiber.
SSPROP_INIT_CONNECT_RETRY_INTERVAL Typ: VT_I4

R/W: Lesen/Schreiben

Standard: 10

Beschreibung: Spezifiziert die Anzahl der Sekunden zwischen jedem Verbindungsversuch im Falle eines Verbindungsverlusts. Weitere Informationen finden Sie unter Idle-Verbindungsresilienz im OLE DB-Treiber.
SSPROP_INIT_CURRENTLANGUAGE Typ: VT_BSTR

R/W: Lesen/Schreiben

Beschreibung: Ein Name einer SQL-Server-Sprache. 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

Standard: 0

Beschreibung: Ermöglicht die Kompatibilität mit Datentypen zwischen SQL Server und ActiveX Data Object (ADO)-Anwendungen. Wird der Standardwert von 0 verwendet, wird der Datentyp standardmäßig auf den vom Anbieter verwendeten Datentyp verwendet. Wenn der Wert von 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 die Server-SPN einer Verbindung abzufragen. (Version 18.6.3 oder höher)
SSPROP_INIT_ENCRYPT 1 Typ: VT_BSTR

R/W: Lesen/Schreiben

Standard: Mandatory

Beschreibung: Spezifiziert, ob die Daten, die über das Netzwerk laufen, verschlüsselt werden sollen.

Wenn Force Protocol Encryption aktiviert ist, findet immer Verschlüsselung statt, unabhängig von der Einstellung von SSPROP_INIT_ENCRYPT. Wenn es aus ist und SSPROP_INIT_ENCRYPT auf Mandatory oder Strictgestellt ist, tritt die Verschlüsselung auf.

Wenn die Force Protocol Encryption deaktiviert ist und SSPROP_INIT_ENCRYPT auf Optionalgesetzt ist, findet keine Verschlüsselung statt. Gültige Werte sind Optional, Mandatory und Strict. Für die Versionen 18.x.x siehe Wesentliche Versionsunterschiede.
SSPROP_INIT_FAILOVERPARTNER Typ: VT_BSTR

R/W: Lesen/Schreiben

Beschreibung: Spezifiziert den Namen des Failover-Partners für Datenbankspiegelung. Es handelt sich um eine Initialisierungseigenschaft und kann nur vor der Initialisierung gesetzt werden. Nach der Initialisierung gibt er den Failover-Partner, falls vorhanden, vom Hauptserver zurückgegeben.

Dies ermöglicht einer intelligenten Anwendung, den zuletzt festgelegten Backup-Server zu cachen, aber solche Anwendungen sollten berücksichtigen, dass die Informationen erst aktualisiert werden, wenn die Verbindung erstmals hergestellt wird (oder bei Pooling zurückgesetzt wird) und für langfristige Verbindungen veraltet werden kann.

Nachdem die Verbindung hergestellt wurde, kann die Anwendung dieses Attribut abfragen, um die Identität des Failover-Partners zu bestimmen. Wenn der primäre Server keinen Failover-Partner hat, gibt diese Eigenschaft einen leeren String zurück. Weitere Informationen finden Sie unter Verwenden der Datenbankspiegelung.
SSPROP_INIT_FAILOVERPARTNERSPN Typ: VT_BSTR

R/W: Lesen/Schreiben

Standard: VT_EMPTY

Beschreibung: Spezifiziert die SPN für den Failover-Partner. 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: Legt den primären Dateinamen einer anhängbaren Datenbank an. Diese Datenbank wird angefügt und als Standarddatenbank für die Verbindung verwendet. Um zu verwenden SSPROP_INIT_FILENAME, müssen Sie den Namen der Datenbank als Wert der Initialisierungseigenschaft DBPROP_INIT_CATALOGangeben. Wenn der Datenbankname nicht existiert, sucht er nach dem in angegebenen SSPROP_INIT_FILENAME primären Dateinamen und fügt diese Datenbank mit dem in DBPROP_INIT_CATALOGangegebenen Namen an. Wenn die Datenbank zuvor angehängt war, hängt SQL Server sie nicht wieder an.
SSPROP_INIT_HOST_NAME_CERTIFICATE Typ: VT_BSTR

R/W: Lesen/Schreiben

Standard: VT_EMPTY

Beschreibung: Der Hostname, der zur Validierung des SQL Server TLS/SSL-Zertifikats verwendet werden soll. Wenn die Eigenschaft SSPROP_INIT_HOST_NAME_CERTIFICATE nicht gesetzt ist, verwendet der Treiber den DBPROP_INIT_DATASOURCE Eigenschaftswert als Hostnamen, um das SQL Server TLS/SSL-Zertifikat zu validieren.
SSPROP_INIT_MARSCONNECTION Typ: VT_BOOL

R/W: Lesen/Schreiben

Standard: 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

Standard: VARIANT_FALSE

Beschreibung: MultiSubnetFailover ermöglicht ein schnelleres Failover für alle Always-On-Verfügbarkeitsgruppen und Failover-Cluster-Instanzen in SQL Server und reduziert die Failover-Zeit für Einzel- und Multi-Subnet-Always-On-Topologien erheblich. Während eines Multi-Subnet-Failovers versucht der Client parallele Verbindungen. 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, der eine Instanz von SQL Server ausführt, die von der Eigenschaft DBPROP_INIT_DATASOURCE angegeben ist.
SSPROP_INIT_NETWORKLIBRARY Typ: VT_BSTR

R/W: Lesen/Schreiben

Beschreibung: Der Name der Netzwerkbibliothek (DLL), die zur Kommunikation mit einer SQL Server-Instanz verwendet wird. Der Name sollte weder den Pfad noch die Dateiendung .dll enthalten.

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

Hinweis: Nur TCP und benannte Pipes werden von dieser Eigenschaft unterstützt. 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: Eine Tabular Data Stream (TDS) Paketgröße in Bytes. Der Wert der Paketgrößen-Eigenschaft muss entweder 0 zwischen 512 und 32.767 liegen. Der Standardwert ist 0, das heißt, die tatsächliche Paketgröße wird vom Server bestimmt.
SSPROP_INIT_SERVER_CERTIFICATE Typ: VT_BSTR

R/W: Lesen/Schreiben

Standard: VT_EMPTY

Beschreibung: Spezifiziert den Pfad zu einer Zertifikatsdatei, der mit dem SQL Server TLS/SSL-Zertifikat übereinstimmt. 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

Standard: VT_EMPTY

Beschreibung: Spezifiziert das SPN für den Server. 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

Standard: 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

Standard: VARIANT_TRUE

Beschreibung: Wenn mehrere IPs mit dem Hostnamen verknüpft sind, beeinflusst TNIR die Verbindungsreihenfolge, wenn die zuerst aufgelöste IP 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_CERTIFICATE 1 Typ: VT_BOOL

R/W: Lesen/Schreiben

Standard: VARIANT_FALSE

Beschreibung: Wird verwendet, um die Validierung von Serverzertifikaten zu aktivieren oder zu deaktivieren. Diese Eigenschaft ist Lese/Schreiben, aber der Versuch, sie nach der Verbindungsaufnahme zu setzen, führt zu einem Fehler.

Diese Eigenschaft wird ignoriert, wenn der Client so konfiguriert ist, dass er eine Zertifikatsüberprüfung erfordert. Eine Anwendung kann sie jedoch zusammen nutzen SSPROP_INIT_ENCRYPT , um sicherzustellen, dass ihre Verbindung zum Server verschlüsselt ist, selbst wenn der Client so konfiguriert ist, dass keine Verschlüsselung erforderlich ist und kein Zertifikat für den Client bereitgestellt wird.

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

Hinweis: Die Verwendung von Verschlüsselung ohne Zertifikatsvalidierung bietet einen teilweisen Schutz gegen Paket-Sniffing, aber nicht gegen Man-in-the-Middle-Angriffe. Es ermöglicht die Verschlüsselung des Logins und der an den Server gesendeten Daten, ohne das Serverzertifikat zu validieren.

Weitere Informationen finden Sie unter Verschlüsselungs- und Zertifikatüberprüfung in OLE DB.
SSPROP_INIT_USEPROCFORPREP Typ: VT_I4

R/W: Lesen/Schreiben

Standard: SSPROPVAL_USEPROCFORPREP_ON

Beschreibung: Die Verwendung des gespeicherten Verfahrens für SQL Server. Definiert die Verwendung von SQL Server temporären Speicherprozeduren 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: Eine temporäre gespeicherte Prozedur wird nicht erstellt, wenn ein Befehl vorbereitet wird.

SSPROPVAL_USEPROCFORPREP_ON: Ein temporäres gespeichertes Verfahren wird erstellt, wenn ein Befehl vorbereitet wird. Die temporär gespeicherten Prozeduren werden gelöscht, wenn die Sitzung freigegeben wird.

SSPROPVAL_USEPROCFORPREP_ON_DROP: Ein temporäres gespeichertes Verfahren wird erstellt, wenn ein Befehl vorbereitet wird. Das Verfahren wird verworfen, wenn der Befehl mit ICommandPrepare::Unprepareunvorbereitet ist, wenn ein neuer Befehl für das Befehlsobjekt mit ICommandText::SetCommandTextangegeben wird, oder wenn alle Anwendungsreferenzen auf den Befehl freigegeben werden.
SSPROP_INIT_WSID Typ: VT_BSTR

R/W: Lesen/Schreiben

Beschreibung: Eine Zeichenkette, die die Arbeitsstation identifiziert.

1 Zur Verbesserung des Sicherheits-, Verschlüsselungs- und Zertifikatüberprüfungsverhaltens wird bei Verwendung von Authentifizierungs-/Zugriffstokeninitialisierungseigenschaften oder den entsprechenden Schlüsselwörtern für verbindungszeichenfolgen geändert. Ausführliche Informationen finden Sie unter Verschlüsselung und Zertifikatüberprüfung.

Im providerspezifischen Eigenschaftssatz DBPROPSET_SQLSERVERDATASOURCEINFOdefiniert der OLE DB-Treiber für SQL Server die zusätzlichen Eigenschaften. Weitere Informationen finden Sie unter Data Source Information Properties.

Der OLE DB Driver für SQL Server String

Der OLE DB-Treiber für SQL Server erkennt eine ODBC-ähnliche Syntax in Anbieterzeichenfolgen-Eigenschaftswerten. Die Provider-String-Eigenschaft wird als Wert der OLE DB-Initialisierungseigenschaft DBPROP_INIT_PROVIDERSTRING angegeben, wenn eine Verbindung zur OLE-Datenbank-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 im OLE DB Driver für SQL Server verfügbaren Schlüsselwörter finden Sie unter Verwendung von Verbindungszeichenbegriffen mit OLE DB Driver für SQL Server.