Initialisierungs- und Autorisierungseigenschaften

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

Eigenschaften-ID	BESCHREIBUNG
DBPROP_AUTH_CACHE_AUTHINFO	Der OLE DB-Anbieter von SQL Server Native Client speichert keine Authentifizierungsinformationen zwischen. Der OLE DB-Anbieter des SQL Server Native Client gibt DB_S_ERRORSOCCURRED zurück, wenn versucht wird, den Eigenschaftswert festzulegen. Das dwStatus-Element der DBPROP-Struktur gibt DBPROPSTATUS_NOTSUPPORTED an.
DBPROP_AUTH_ENCRYPT_PASSWORD	Der OLE DB-Anbieter von SQL Server Native Client verwendet standardmäßige MicrosoftSQL Server-Sicherheitsmechanismen, um Kennwörter zu verbergen. Der OLE DB-Anbieter des SQL Server Native Client gibt DB_S_ERRORSOCCURRED zurück, wenn versucht wird, den Eigenschaftswert festzulegen. 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 OLE DB-Anbieter von SQL Server Native Client Den Windows-Authentifizierungsmodus, um den Benutzerzugriff auf die SQL Server-Datenbank zu autorisieren, die durch die eigenschaften DBPROP_INIT_DATASOURCE und DBPROP_INIT_CATALOG angegeben wird. Wenn sie auf VT_EMPTY (Standardeinstellung) festgelegt ist, wird sql Server-Sicherheit verwendet. Die SQL Server-Anmeldung und das Kennwort werden in den Eigenschaften DBPROP_AUTH_USERID und DBPROP_AUTH_PASSWORD angegeben.
DBPROP_AUTH_MASK_PASSWORD	Der OLE DB-Anbieter von SQL Server Native Client verwendet standardmäßige SQL Server-Sicherheitsmechanismen, um Kennwörter zu verbergen. Der OLE DB-Anbieter des SQL Server Native Client gibt DB_S_ERRORSOCCURRED zurück, wenn versucht wird, den Eigenschaftswert festzulegen. Das dwStatus-Element der DBPROP-Struktur gibt DBPROPSTATUS_NOTSUPPORTED an.
DBPROP_AUTH_PASSWORD	Kennwort, das einer SQL Server-Anmeldung zugewiesen ist. Diese Eigenschaft wird verwendet, wenn die SQL Server-Authentifizierung für die Autorisierung des Zugriffs auf eine SQL Server-Datenbank ausgewählt wird.
DBPROP_AUTH_PERSIST_ENCRYPTED	Der OLE DB-Anbieter von SQL Server Native Client verschlüsselt keine Authentifizierungsinformationen, wenn sie beibehalten werden. Der OLE DB-Anbieter des SQL Server Native Client gibt DB_S_ERRORSOCCURRED zurück, wenn versucht wird, den Eigenschaftswert festzulegen. Das dwStatus-Element der DBPROP-Struktur gibt DBPROPSTATUS_NOTSUPPORTED an.
DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO	Der OLE DB-Anbieter von SQL Server Native Client speichert Authentifizierungswerte, einschließlich eines Bilds eines Kennworts, falls erforderlich. Es wird keine Verschlüsselung bereitgestellt.
DBPROP_AUTH_USERID	SQL Server-Anmeldung. Diese Eigenschaft wird verwendet, wenn die SQL Server-Authentifizierung für die Autorisierung des Zugriffs auf eine SQL Server-Datenbank ausgewählt wird.
DBPROP_INIT_ASYNCH	Der OLE DB-Anbieter von SQL Server Native Client unterstützt asynchrone Initiierung. Das Festlegen des DBPROPVAL_ASYNCH_INITIALIZE Bits in der DBPROP_INIT_ASYNCH-Eigenschaft bewirkt , dass IDBInitialize::Initialize zu einem nicht blockierenden Aufruf wird. Weitere Informationen finden Sie unter Ausführen asynchroner Vorgänge.
DBPROP_INIT_CATALOG	Name einer vorhandenen SQL Server-Datenbank, mit der eine Verbindung hergestellt werden soll.
DBPROP_INIT_DATENQUELLE	Netzwerkname eines Servers, auf dem eine Instanz von MicrosoftSQL Server ausgeführt wird. Wenn mehrere Instanzen von SQL Server auf dem Computer ausgeführt werden, um eine Verbindung mit einer bestimmten Instanz von SQL Server herzustellen, wird der Wert DBPROP_INIT_DATASOURCE als \\ServerName\InstanceName angegeben. Die Escapesequenz \\ wird für umgekehrten Schrägstrich selbst verwendet.
DBPROP_INIT_GENERALTIMEOUT	Gibt die Anzahl von Sekunden vor einer Anforderung an, außer der Datenquelleninitialisierung und Befehlsausführung, ein Zeitüberschreitung. Ein Wert von 0 gibt einen unendlichen Timeout an. Anbieter, die über Netzwerkverbindungen oder in verteilten oder transaktionsbasierten Szenarien arbeiten, können diese Eigenschaft unterstützen, um eine aufgelistete Komponente für einen Timeout im Falle einer langfristigen Anforderung zu empfehlen. Timeouts für die Initialisierung der Datenquelle und die Ausführung von Befehlen unterliegen DBPROP_INIT_TIMEOUT bzw. DBPROP_COMMANDTIMEOUT. DBPROP_INIT_GENERALTIMEOUT ist schreibgeschützt, und wenn versucht wird, ihn festzulegen, wird der Dwstatus-Fehler von DBPROPSTATUS_NOTSETTABLE zurückgegeben.
DBPROP_INIT_HWND	Das Windows-Handle von der aufrufenden Anwendung. Ein gültiges Fensterhandle ist für das Initialisierungsdialogfeld erforderlich, das angezeigt wird, wenn die Aufforderung zur Initialisierungseigenschaften zulässig ist.
DBPROP_INIT_IMPERSONATION_LEVEL	Der OLE DB-Anbieter von SQL Server Native Client unterstützt keine Anpassung der Identitätswechselebene. Der OLE DB-Anbieter des SQL Server Native Client gibt DB_S_ERRORSOCCURRED zurück, wenn versucht wird, den Eigenschaftswert festzulegen. Das dwStatus-Element der DBPROP-Struktur gibt DBPROPSTATUS_NOTSUPPORTED an.
DBPROP_INIT_LCID	Der OLE DB-Anbieter von SQL Server Native Client ü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 OLE DB-Anbieter des SQL Server Native Client gibt DB_S_ERRORSOCCURRED zurück, wenn versucht wird, den Eigenschaftswert festzulegen. Das dwStatus-Element der DBPROP-Struktur gibt DBPROPSTATUS_NOTSUPPORTED an.
DBPROP_INIT_MODE	Der OLE DB-Anbieter des SQL Server Native Client gibt DB_S_ERRORSOCCURRED zurück, wenn versucht wird, den Eigenschaftswert festzulegen. Das dwStatus-Element der DBPROP-Struktur gibt DBPROPSTATUS_NOTSUPPORTED an.
Eingabeaufforderung für DBPROP_INIT	Der OLE DB-Anbieter von SQL Server Native Client unterstützt alle Aufforderungsmodi für die Datenquelleninitialisierung. Der OLE DB-Anbieter von SQL Server Native Client verwendet DBPROMPT_NOPROMPT als Standardeinstellung für die Eigenschaft.
DBPROP_INIT_PROTECTION_LEVEL	Der OLE DB-Anbieter von SQL Server Native Client unterstützt keine Schutzebene für Verbindungen mit Instanzen von SQL Server. Der OLE DB-Anbieter des SQL Server Native Client gibt DB_S_ERRORSOCCURRED zurück, wenn versucht wird, den Eigenschaftswert festzulegen. Das dwStatus-Element der DBPROP-Struktur gibt DBPROPSTATUS_NOTSUPPORTED an.
DBPROP_INIT_PROVIDERSTRING	Weitere Informationen finden Sie in der OLE DB-Anbieterzeichenfolge des SQL Server Native Client weiter unten in diesem Thema.
DBPROP_INIT_TIMEOUT	Der OLE DB-Anbieter des SQL Server Native Client gibt einen Fehler bei der Initialisierung zurück, wenn innerhalb der angegebenen Anzahl von Sekunden keine Verbindung mit der SQL Server-Instanz hergestellt werden kann.

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

Eigenschaften-ID	BESCHREIBUNG
SSPROP_AUTH_OLD_PASSWORD	Typ: VT_BSTR R/W: Schreiben Standard: 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: Lese-/Schreibzugriff Beschreibung: Der Name der Clientanwendung.
SSPROP_INIT_AUTOTRANSLATE	Typ: VT_BOOL R/W: Lese-/Schreibzugriff Standard: VARIANT_TRUE Beschreibung: OEM/ANSI-Zeichenkonvertierung. VARIANT_TRUE: Der OLE DB-Anbieter des SQL Server Native Client übersetzt ANSI-Zeichenfolgen, die zwischen dem Client und dem Server gesendet werden, indem er über Unicode konvertiert wird, um Probleme beim Abgleichen erweiterter Zeichen zwischen den Codeseiten auf dem Client und dem Server zu minimieren: Client-DBTYPE_STR Daten, die an eine Instanz von SQLServer-Zeichen,Varchar oder Textvariablen , Parametern oder Spalten gesendet werden, werden mithilfe der Client-ANSI-Codeseite (ACP) von Unicode in Zeichen mithilfe des ACP des Servers konvertiert. SQL Server-Zeichen-, Varchar- oder Textdaten , die an einen Client gesendet werden, DBTYPE_STR Variable werden mithilfe des Server ACP in Unicode konvertiert und dann von Unicode in Zeichen mithilfe des Client ACP konvertiert. Diese Konvertierungen werden auf dem Client vom SQL Server Native Client OLE DB-Anbieter ausgeführt. Dies erfordert, dass der auf dem Server verwendete ACP auf dem Client verfügbar ist. Diese Einstellungen haben keine Auswirkungen auf die Konvertierungen, die für diese Übertragungen auftreten: Unicode-DBTYPE_WSTR Clientdaten, die an Zeichen, Varchar oder Text auf dem Server gesendet werden. Char-, Varchar- oder Textserverdaten , 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-Zeichen-, Varchar- oder Textserverdaten, die an eine ANSI-DBTYPE_STR Variable auf dem Client gesendet werden. VARIANT_FALSE: Der OLE DB-Anbieter des SQL Server Native Client führt keine Zeichenübersetzungen durch. Der OLE DB-Anbieter des SQL Server Native Client übersetzt keine Client-ANSI-Zeichen DBTYPE_STR Daten, die an Zeichen, Varchar oder Textvariablen , Parameter oder Spalten auf dem Server gesendet werden. Es werden keine Übersetzungen für Zeichen-, Varchar- oder Textdaten ausgefü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 erweiterte Zeichen falsch interpretiert werden.
SSPROP_INIT_CURRENTLANGUAGE	Typ: VT_BSTR R/W: Lese-/Schreibzugriff Beschreibung: Ein SQL Server-Sprachname. Identifiziert die Sprache, die für die Auswahl und Formatierung von Systemnachrichten verwendet wird. Die Sprache muss auf dem Computer installiert werden, auf dem eine Instanz von SQL Server ausgeführt wird, oder die Initialisierung der Datenquelle schlägt fehl.
SSPROP_INIT_DATATYPECOMPATIBILITY	Typ: VT_UI2 R/W: Lese-/Schreibzugriff Standardwert: 0 Beschreibung: Ermöglicht die Datentypkompatibilität zwischen SQL Server- und ActiveX-Datenobjektanwendungen (ADO). Wenn der Standardwert von 0 verwendet wird, wird standardmäßig der datentypverwendete Datentyp verwendet, der vom Anbieter verwendet wird. Wenn der Wert 80 verwendet wird, verwendet die Datentypbehandlung nur SQL Server 2000-Datentypen. Weitere Informationen finden Sie unter Verwenden von ADO mit SQL Server Native Client.
SSPROP_INIT_ENCRYPT	Typ: VT_BOOL R/W: Lese-/Schreibzugriff Standard: VARIANT_FALSE Beschreibung: Um die Daten über das Netzwerk zu verschlüsseln, wird SSPROP_INIT_ENCRYPT Eigenschaft auf VARIANT_TRUE festgelegt. Wenn die Protokollverschlüsselung aktiviert ist, erfolgt die Verschlüsselung immer, unabhängig von der Einstellung von SSPROP_INIT_ENCRYPT. Wenn sie deaktiviert ist und SSPROP_INIT_ENCRYPT auf VARIANT_TRUE festgelegt ist, erfolgt die Verschlüsselung. Wenn die Protokollverschlüsselung deaktiviert ist und SSPROP_INIT_ENCRYPT auf VARIANT_FALSE festgelegt ist, tritt keine Verschlüsselung auf.
SSPROP_INIT_FAILOVERPARTNER	Typ: VT_BSTR R/W: Lese-/Schreibzugriff Beschreibung: Gibt den Namen des Failoverpartners für die Datenbankspiegelung an. Es handelt sich um eine Initialisierungseigenschaft und kann nur vor der Initialisierung festgelegt werden. Nach der Initialisierung wird der Failoverpartner (sofern vorhanden) vom primären Server zurückgegeben. Dies ermöglicht es einer intelligenten Anwendung, den zuletzt ermittelten Sicherungsserver zwischenzuspeichern, aber solche Anwendungen sollten beachten, dass die Informationen nur aktualisiert werden, wenn die Verbindung zum ersten Mal eingerichtet (oder zurückgesetzt wird, wenn sie in Einem Pool zusammengefasst ist) und für langfristige Verbindungen veraltet werden kann. Nach dem Herstellen der Verbindung kann die Anwendung dieses Attribut abfragen, um die Identität des Failoverpartners zu ermitteln. Wenn der primäre Server keinen Failoverpartner hat, gibt diese Eigenschaft eine leere Zeichenfolge zurück. Weitere Informationen finden Sie unter Verwenden der Datenbankspiegelung.
SSPROP_INIT_FILENAME	Typ: VT_BSTR R/W: Lese-/Schreibzugriff Beschreibung: Gibt den primären Dateinamen einer anfügenden Datenbank an. Diese Datenbank ist angefügt und wird zur Standarddatenbank für die Verbindung. Um SSPROP_INIT_FILENAME zu verwenden, müssen Sie den Namen der Datenbank als Wert der Initialisierungseigenschaft DBPROP_INIT_CATALOG angeben. Wenn der Datenbankname nicht vorhanden ist, sucht er nach dem primären Dateinamen, der in SSPROP_INIT_FILENAME angegeben ist, und fügt diese Datenbank mit dem in DBPROP_INIT_CATALOG angegebenen Namen an. Wenn die Datenbank zuvor angefügt wurde, wird sie von SQL Server nicht erneut angefügt.
SSPROP_INIT_MARSCONNECTION	Typ: VT_BOOL R/W: Lese-/Schreibzugriff Standard: VARIANT_FALSE Beschreibung: Gibt an, ob mehrere aktive Resultsets (MARS) für die Verbindung aktiviert sind. Diese Option muss auf "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: Lese-/Schreibzugriff Beschreibung: Die Netzwerkadresse des Servers, auf dem eine Instanz von SQL Server ausgeführt wird, die durch die eigenschaft DBPROP_INIT_DATASOURCE angegeben wird.
SSPROP_INIT_NETWORKLIBRARY	Typ: VT_BSTR R/W: Lese-/Schreibzugriff Beschreibung: Der Name der Networklibrary (DLL), die für die Kommunikation mit einer Instanz von SQL Server verwendet wird. Der Name sollte nicht den Pfad oder die .dll Dateinamenerweiterung enthalten. Der Standardwert kann mithilfe des SQL Server-Clientkonfigurationsprogramms angepasst werden. Anmerkung: Nur TCP und Named Pipes werden von dieser Eigenschaft unterstützt. Wenn Sie diese Eigenschaft mit einem Präfix verwenden, haben Sie ein doppeltes Präfix, das zu einem Fehler führt, da die Eigenschaft verwendet wird, um intern ein Präfix zu generieren.
SSPROP_INIT_PACKETSIZE	Typ: VT_I4 R/W: Lese-/Schreibzugriff Beschreibung: Eine Netzwerkpaketgröße in Byte. Der Paketgröße-Eigenschaftswert muss zwischen 512 und 32.767 sein. Die standardmäßige OLE DB-Netzwerkpaketgröße des SQL Server Native Client OLE DB-Anbieters beträgt 4.096.
SSPROP_INIT_TAGCOLUMNCOLLATION	Typ: BOOL R/W: Schreiben Standard: FALSE Beschreibung: Wird während einer Datenbankaktualisierung verwendet, wenn serverseitige Cursor verwendet werden. Diese Eigenschaft markiert die Daten mit Sortierungsinformationen, die vom Server statt der Codeseite auf dem Client abgerufen werden. Derzeit wird diese Eigenschaft nur vom verteilten Abfrageprozess verwendet, da sie die Sortierung von Zieldaten kennt und sie richtig konvertiert.
SSPROP_INIT_TRUST_SERVER_CERTIFICATE	Typ: VT_BOOL R/W: Lese-/Schreibzugriff Standard: VARIANT_FALSE Beschreibung: Wird verwendet, um die Serverzertifikatüberprüfung zu aktivieren oder zu deaktivieren. Diese Eigenschaft ist lese-/schreibgeschützt, aber der Versuch, sie festzulegen, nachdem eine Verbindung hergestellt wurde, führt zu einem Fehler. Diese Eigenschaft wird ignoriert, wenn der Client für die Zertifikatüberprüfung konfiguriert ist. Eine Anwendung kann sie jedoch zusammen mit SSPROP_INIT_ENCRYPT verwenden, um sicherzustellen, dass die Verbindung mit dem Server verschlüsselt ist, auch wenn der Client so konfiguriert ist, dass keine Verschlüsselung erforderlich ist und kein Zertifikat auf dem Client bereitgestellt wird. Clientanwendungen können diese Eigenschaft abfragen, nachdem eine Verbindung geöffnet wurde, um die tatsächlich verwendeten Verschlüsselungs- und Überprüfungseinstellungen zu ermitteln. Anmerkung: Die Verwendung von Verschlüsselung ohne Zertifikatüberprüfung bietet teilweisen Schutz vor Paketsiffing, schützt jedoch nicht vor Man-in-the-Middle-Angriffen. Es ermöglicht einfach, die an den Server gesendeten Anmelde- und Daten zu verschlüsseln, ohne das Serverzertifikat zu validieren. Weitere Informationen finden Sie unter Verwenden von Verschlüsselung ohne Überprüfung.
SSPROP_INIT_USEPROCFORPREP	Typ: VT_I4 R/W: Lese-/Schreibzugriff Standard: SSPROPVAL_USEPROCFORPREP_ON Beschreibung: Die verwendung der gespeicherten SQL Server-Prozedur. Definiert die Verwendung temporärer gespeicherter SQL Server-Prozeduren zur Unterstützung der ICommandPrepare-Schnittstelle . Diese Eigenschaft war nur beim Herstellen einer Verbindung mit SQL Server 6.5 aussagekräftig. Die Eigenschaft wird für spätere Versionen ignoriert. SSPROPVAL_USEPROCFORPREP_OFF: Eine temporäre gespeicherte Prozedur wird nicht erstellt, wenn ein Befehl vorbereitet wird. SSPROPVAL_USEPROCFORPREP_ON: Eine temporäre gespeicherte Prozedur wird erstellt, wenn ein Befehl vorbereitet wird. Die temporären gespeicherten Prozeduren werden gelöscht, wenn die Sitzung freigegeben wird. SSPROPVAL_USEPROCFORPREP_ON_DROP: Eine temporäre gespeicherte Prozedur wird erstellt, wenn ein Befehl vorbereitet wird. Die Prozedur wird gelöscht, wenn der Befehl nicht mit "ICommandPrepare::Unprepare", wenn ein neuer Befehl für das Befehlsobjekt mit "ICommandText::SetCommandText" angegeben wird oder wenn alle Anwendungsverweise auf den Befehl freigegeben werden.
SSPROP_INIT_WSID	Typ: VT_BSTR R/W: Lese-/Schreibzugriff Beschreibung: Eine Zeichenfolge, die die Arbeitsstation identifiziert.

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

Die OLE DB-Anbieterzeichenfolge des nativen SQL Server-Clients

Der OLE DB-Anbieter von SQL Server Native Client erkennt eine ODBC-ähnliche Syntax in Zeichenfolgenwerten des Anbieters. Die Anbieterzeichenfolgeneigenschaft wird als Wert der OLE DB-Initialisierungseigenschaft DBPROP_INIT_PROVIDERSTRING bereitgestellt, wenn eine Verbindung mit der OLE DB-Datenquelle hergestellt wird. Diese Eigenschaft gibt anbieterspezifische OLE DB-Verbindungsdaten an, die zum Implementieren einer Verbindung mit der OLE DB-Datenquelle erforderlich sind. Innerhalb der Zeichenfolge werden Elemente durch ein Semikolon getrennt. Das letzte Element in der Zeichenfolge muss mit einem Semikolon beendet werden. Jedes Element besteht aus einem Schlüsselwort, einem Gleichheitszeichen und dem an die Initialisierung übergebenen Wert. Beispiel:

Server=MyServer;UID=MyUserName;  

Beim OLE DB-Anbieter des SQL Server Native Client muss der Consumer niemals die Anbieterzeichenfolgeneigenschaft verwenden. Der Consumer kann jede Initialisierungseigenschaft, die in der Anbieterzeichenfolge widergespiegelt wird, mithilfe von OLE DB- oder SQL Server Native Client OLE DB-anbieterspezifischen Initialisierungseigenschaften festlegen.

Eine Liste der Im SQL Server Native Client OLE DB-Anbieter verfügbaren Schlüsselwörter finden Sie unter Verwenden von Verbindungszeichenfolgenstichwörtern mit SQL Server Native Client.

Siehe auch

Datenquellenobjekte (OLE DB)