Initialisierungs- und Autorisierungseigenschaften (nativer OLE DB-Clientanbieter)

  • Artikel

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

Wichtig

Der SQL Server Native Client (häufig abgekürzt mit SNAC) wurde aus SQL Server 2022 (16.x) und SQL Server Management Studio 19 (SSMS) entfernt. Sowohl der OLE DB-Anbieter für den SQL Server Native Client (SQLNCLI oder SQLNCLI11) als auch der Microsoft OLE DB-Legacyanbieter für SQL Server (SQLOLEDB) werden für Neuentwicklungen nicht empfohlen. Verwenden Sie in Zukunft den neuen Microsoft OLE DB-Treiber für SQL Server (MSOLEDBSQL).

Der SQL Server Native Client OLE DB-Anbieter interpretiert OLE DB-Initialisierungs- und Autorisierungseigenschaften wie folgt:

Eigenschafts-ID BESCHREIBUNG
DBPROP_AUTH_CACHE_AUTHINFO Der SQL Server Native Client OLE DB-Anbieter speichert keine Authentifizierungsinformationen zwischen.

Der SQL Server Native Client OLE DB-Anbieter 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 SQL Server Native Client OLE DB-Anbieter verwendet standardmäßige Sicherheitsmechanismen von Microsoft SQL Server, um Kennwörter zu verbergen.

Der SQL Server Native Client OLE DB-Anbieter 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 ist, verwendet der SQL Server Native Client OLE DB-Anbieter den Windows-Authentifizierungsmodus, um den Benutzerzugriff auf die durch die 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 SQL Server Native Client OLE DB-Anbieter verwendet standardmäßige SQL Server Sicherheitsmechanismen, um Kennwörter zu verbergen.

Der SQL Server Native Client OLE DB-Anbieter 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 Die SQL Server Native Client OLE DB-Anbieters verschlüsselt keine Authentifizierungsinformationen, wenn sie beibehalten werden.

Der SQL Server Native Client OLE DB-Anbieter 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 SQL Server Native Client OLE DB-Anbieter speichert Authentifizierungswerte, einschließlich des Images eines Kennworts, bei Bedarf. 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 SQL Server Native Client OLE DB-Anbieter unterstützt die asynchrone Initiierung.

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 unterstützen, um das Timeout einer gelisteten Komponente bei zeitaufwändigen Anforderungen zu vermeiden. 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 SQL Server Native Client OLE DB-Anbieter unterstützt keine Anpassung der Identitätswechselebene.

Der SQL Server Native Client OLE DB-Anbieter 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 SQL Server Native Client OLE DB-Anbieter überprüft die Gebietsschema-ID und gibt einen Fehler zurück, wenn die Gebietsschema-ID nicht unterstützt wird oder nicht auf dem Client installiert ist.
DBPROP_INIT_LOCATION Der SQL Server Native Client OLE DB-Anbieter 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 SQL Server Native Client OLE DB-Anbieter 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 SQL Server Native Client OLE DB-Anbieter unterstützt alle Aufforderungsmodi für die Datenquelleninitialisierung. Der SQL Server Native Client OLE DB-Anbieter verwendet DBPROMPT_NOPROMPT als Standardeinstellung für die Eigenschaft.
DBPROP_INIT_PROTECTION_LEVEL Der SQL Server Native Client OLE DB-Anbieter unterstützt keine Schutzebene für Verbindungen mit Instanzen von SQL Server.

Der SQL Server Native Client OLE DB-Anbieter 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 Weitere Informationen finden Sie weiter unten in diesem Thema unter SQL Server Native Client OLE DB-Anbieterzeichenfolge.
DBPROP_INIT_TIMEOUT Der SQL Server Native Client OLE DB-Anbieter gibt bei der Initialisierung einen Fehler zurück, wenn innerhalb der angegebenen Anzahl von Sekunden keine Verbindung mit der Instanz von SQL Server hergestellt werden kann.

Im anbieterspezifischen Eigenschaftensatz DBPROPSET_SQLSERVERDBINIT definiert der SQL Server Native Client OLE DB-Anbieter diese zusätzlichen Initialisierungseigenschaften.

Eigenschafts-ID BESCHREIBUNG
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 SQL Server Native Client OLE DB-Anbieter übersetzt die zwischen Client und Server gesendeten ANSI-Zeichenfolgen durch Konvertierung über Unicode, um Probleme beim Abgleichen erweiterter Zeichen zwischen den Codepages auf dem Client und dem Server zu minimieren:

Client-DBTYPE_STR-Daten, die an eine Instanz von SQL Serverchar-, 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.

Diese Konvertierungen werden auf dem Client vom SQL Server Native Client OLE DB-Anbieter ausgefü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 SQL Server Native Client OLE DB-Anbieter führt keine Zeichenübersetzungen aus.

Der SQL Server Native Client OLE DB-Anbieter übersetzt keine Client-ANSI-Zeichen DBTYPE_STR Daten, die an Char-, Varchar- oder Textvariablen, 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.

Wenn der Client und die Instanz von SQL Server unterschiedliche ACPs verwenden, können Sonderzeichen fehlinterpretiert werden.
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 SQL Server Native Client.
SSPROP_INIT_ENCRYPT Typ: VT_BOOL

R/W: Lesen/Schreiben

Standardwert: VARIANT_FALSE

Beschreibung: Zur Verschlüsselung von Daten, die über das Netzwerk gesendet werden, wird die SSPROP_INIT_ENCRYPT-Eigenschaft auf VARIANT_TRUE festgelegt.

Wenn die Protokollverschlüsselung aktiviert ist, wird immer verschlüsselt, unabhängig von der Einstellung von SSPROP_INIT_ENCRYPT. Wenn sie deaktiviert ist und SSPROP_INIT_ENCRYPT auf VARIANT_TRUE festgelegt wird, wird verschlüsselt.

Wenn die Protokollverschlüsselung deaktiviert ist und SSPROP_INIT_ENCRYPT auf VARIANT_FALSE festgelegt wird, wird nicht verschlüsselt.
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.

Dies ermöglicht einer intelligenten Anwendung, den aktuell festgestellten Sicherungsserver in den Cache zu speichern. Jedoch sollte bei solchen Anwendungen darauf geachtet werden, dass die Informationen nur aktualisiert werden, wenn die Verbindung zum ersten Mal hergestellt (oder zurückgesetzt, falls in einem Pool) wird, und bei Langzeitverbindungen veralten kann.

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_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_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_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: Eine Netzwerkpaketgröße in Bytes. Der Paketgrößen-Eigenschaftswert muss zwischen 512 und 32.767 liegen. Die Standardgröße SQL Server Native Client OLE DB-Anbieternetzwerkpakets ist 4.096.
SSPROP_INIT_TAGCOLUMNCOLLATION Typ: BOOL

R/W: Schreiben

Standardwert: 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_TRUST_SERVER_CERTIFICATE 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 Verwenden von Verschlüsselung ohne Ü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.

Im anbieterspezifischen Eigenschaftensatz DBPROPSET_SQLSERVERDATASOURCEINFO definiert der SQL Server Native Client OLE DB-Anbieter die zusätzlichen Eigenschaften. Weitere Informationen finden Sie unter Datenquelleninformationseigenschaften.

Die SQL Server Native Client OLE DB-Anbieterzeichenfolge

Der SQL Server Native Client OLE DB-Anbieters erkennt eine ODBC-ähnliche Syntax in Eigenschaftswerten der Anbieterzeichenfolge. 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 SQL Server Native Client OLE DB-Anbieters muss der Consumer niemals die Anbieterzeichenfolgeneigenschaft verwenden. Der Consumer kann jede Initialisierungseigenschaft festlegen, die in der Anbieterzeichenfolge widergespiegelt wird, indem er OLE DB oder SQL Server Native Client anbieterspezifischen Initialisierungseigenschaften für OLE DB verwendet.

Eine Liste der Schlüsselwörter, die im SQL Server Native Client OLE DB-Anbieter verfügbar sind, finden Sie unter Verwenden von Schlüsselwörtern für Verbindungszeichenfolgen mit SQL Server Native Client.

Weitere Informationen

Datenquellenobjekte (OLE DB)