Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
gäller för:
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)
Important
Den interna SQL Server-klienten (ofta förkortad SNAC) har tagits bort från SQL Server 2022 (16.x) och SQL Server Management Studio 19 (SSMS). Både SQL Server Native Client OLE DB-providern (SQLNCLI eller SQLNCLI11) och den äldre Microsoft OLE DB-providern för SQL Server (SQLOLEDB) rekommenderas inte för ny utveckling. Växla till den nya Microsoft OLE DB Driver (MSOLEDBSQL) för SQL Server framöver.
SQL Server Native Client OLE DB-leverantören tolkar OLE DB-initialiserings- och auktoriseringsegenskaper enligt följande:
| Egenskaps-ID | Description |
|---|---|
| DBPROP_AUTH_CACHE_AUTHINFO | SQL Server Native Client OLE DB-leverantören cachar inte autentiseringsinformation. Den SQL Server Native Client OLE DB-leverantören returnerar DB_S_ERRORSOCCURRED vid ett försök att sätta egenskapsvärdet. DwStatus-medlemmen i DBPROP-strukturen indikerar DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_AUTH_ENCRYPT_PASSWORD | SQL Server Native Client OLE DB-leverantören använder standardiserade Microsoft SQL Server-säkerhetsmekanismer för att dölja lösenord. Den SQL Server Native Client OLE DB-leverantören returnerar DB_S_ERRORSOCCURRED vid ett försök att sätta egenskapsvärdet. DwStatus-medlemmen i DBPROP-strukturen indikerar DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_AUTH_INTEGRATED | Om DBPROP_AUTH_INTEGRATED sätts till en NULL-pekare, en nullsträng eller ett 'SSPI'-VT_BSTR värde, använder den SQL Server Native Client OLE DB-leverantören Windows autentiseringsläge för att auktorisera användaråtkomst till den SQL Server-databas som specificeras av DBPROP_INIT_DATASOURCE- och DBPROP_INIT_CATALOG-egenskaperna. Om den är inställd på VT_EMPTY (standard) används SQL Server-säkerhet. SQL Server-inloggning och lösenord specificeras i egenskaperna DBPROP_AUTH_USERID och DBPROP_AUTH_PASSWORD. |
| DBPROP_AUTH_MASK_PASSWORD | SQL Server Native Client OLE DB-leverantören använder standardiserade SQL Server-säkerhetsmekanismer för att dölja lösenord. Den SQL Server Native Client OLE DB-leverantören returnerar DB_S_ERRORSOCCURRED vid ett försök att sätta egenskapsvärdet. DwStatus-medlemmen i DBPROP-strukturen indikerar DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_AUTH_PASSWORD | Lösenord tilldelat en SQL Server-inloggning. Denna egenskap används när SQL Server-autentisering väljs för att auktorisera åtkomst till en SQL Server-databas. |
| DBPROP_AUTH_PERSIST_ENCRYPTED | SQL Server Native Client OLE DB-leverantören krypterar inte autentiseringsinformation när den upprätthålls. Den SQL Server Native Client OLE DB-leverantören returnerar DB_S_ERRORSOCCURRED vid ett försök att sätta egenskapsvärdet. DwStatus-medlemmen i DBPROP-strukturen indikerar DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO | SQL Server Native Client OLE DB-leverantören behåller autentiseringsvärden, inklusive en bild av ett lösenord, om det efterfrågas. Ingen kryptering tillhandahålls. |
| DBPROP_AUTH_USERID | Inloggning till SQL Server. Denna egenskap används när SQL Server-autentisering väljs för att auktorisera åtkomst till en SQL Server-databas. |
| DBPROP_INIT_ASYNCH | SQL Server Native Client OLE DB-leverantören stödjer asynkron initiering. Att sätta DBPROPVAL_ASYNCH_INITIALIZE bit i egenskapen DBPROP_INIT_ASYNCH gör att IDBInitialize::Initialize blir ett icke-blockerande anrop. För mer information, se Utförande av asynkrona operationer. |
| DBPROP_INIT_CATALOG | Namnet på en befintlig SQL Server-databas att ansluta till. |
| DBPROP_INIT_DATASOURCE | Nätverksnamn på en server som kör en instans av Microsoft SQL Server. Om det finns flera instanser av SQL Server som körs på datorn, specificeras värdet DBPROP_INIT_DATASOURCE som \\ServerName\InstanceName för att ansluta till en specifik instans av SQL Server. Flyktsekvensen används för själva backslashen. |
| DBPROP_INIT_GENERALTIMEOUT | Anger antalet sekunder innan en begäran, förutom initialisering av datakällan och kommandoexekvering, går ut i tid. Ett värde på 0 indikerar en oändlig timeout. Leverantörer som arbetar över nätverksanslutningar eller i distribuerade eller transakterade scenarier kan stödja denna egenskap för att råda en underofficer att timeout vid en långvarig begäran. Timeouts för initialisering av datakällor och kommandoexekvering styrs fortfarande av DBPROP_INIT_TIMEOUT respektive DBPROP_COMMANDTIMEOUT. DBPROP_INIT_GENERALTIMEOUT är skrivskyddad, och om man försöker sätta den returneras dwstatus-felet DBPROPSTATUS_NOTSETTABLE. |
| DBPROP_INIT_HWND | Windows-handtaget från den anropande applikationen. Ett giltigt fönsterhandtag krävs för initialiseringsdialogrutan som visas när det är tillåtet att be om initialiseringsegenskaper. |
| DBPROP_INIT_IMPERSONATION_LEVEL | SQL Server Native Client OLE DB-leverantören stöder inte justering av imitationsnivå. Den SQL Server Native Client OLE DB-leverantören returnerar DB_S_ERRORSOCCURRED vid ett försök att sätta egenskapsvärdet. DwStatus-medlemmen i DBPROP-strukturen indikerar DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_INIT_LCID | SQL Server Native Client OLE DB-leverantören validerar lokal-ID och ger ett felmeddelande om lokal-ID:t inte stöds eller inte är installerat på klienten. |
| DBPROP_INIT_LOCATION | Den SQL Server Native Client OLE DB-leverantören returnerar DB_S_ERRORSOCCURRED vid ett försök att sätta egenskapsvärdet. DwStatus-medlemmen i DBPROP-strukturen indikerar DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_INIT_MODE | Den SQL Server Native Client OLE DB-leverantören returnerar DB_S_ERRORSOCCURRED vid ett försök att sätta egenskapsvärdet. DwStatus-medlemmen i DBPROP-strukturen indikerar DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_INIT_PROMPT | SQL Server Native Client OLE DB-leverantören stöder alla promptlägen för initialisering av datakällor. Den ursprungliga Native Client OLE DB-leverantören SQL Server använder DBPROMPT_NOPROMPT som standardinställning för egenskapen. |
| DBPROP_INIT_PROTECTION_LEVEL | SQL Server Native Client OLE DB-leverantören stöder inte någon skyddsnivå för anslutningar till instanser av SQL Server. Den SQL Server Native Client OLE DB-leverantören returnerar DB_S_ERRORSOCCURRED vid ett försök att sätta egenskapsvärdet. DwStatus-medlemmen i DBPROP-strukturen indikerar DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_INIT_PROVIDERSTRING | Se SQL Server Native Client OLE DB-leverantörssträngen senare i detta ämne. |
| DBPROP_INIT_TIMEOUT | SQL Server Native Client OLE DB-leverantören ger ett fel vid initiering om en anslutning till SQL Server-instansen inte kan upprättas inom det angivna antalet sekunder. |
I den leverantörsspecifika egenskapsuppsättningen DBPROPSET_SQLSERVERDBINIT definierar den SQL Server Native Client OLE DB-leverantören dessa ytterligare initialiseringsegenskaper.
| Egenskaps-ID | Description |
|---|---|
| SSPROP_AUTH_OLD_PASSWORD | Typ: VT_BSTR R/W: Skriv Standard: VT_EMPTY Beskrivning: Det aktuella eller utgångna lösenordet. För mer information, se Byta lösenord programmatiskt. |
| SSPROP_INIT_APPNAME | Typ: VT_BSTR R/W: Läs/skriv Beskrivning: Namnet på klientapplikationen. |
| SSPROP_INIT_AUTOTRANSLATE | Typ: VT_BOOL R/W: Läs/skriv Standard: VARIANT_TRUE Beskrivning: OEM/ANSI-teckenkonvertering. VARIANT_TRUE: Den SQL Server Native Client OLE DB-leverantören översätter ANSI-teckensträngar som skickas mellan klient och server genom att konvertera via Unicode för att minimera problem med att matcha utökade tecken mellan kodsidorna på klienten och servern: Klientdata DBTYPE_STR som skickas till en instans av SQL Server char, varchar eller textvariabel, parameter eller kolumn konverteras från tecken till Unicode med hjälp av klientens ANSI-kodsida (ACP) och konverteras sedan från Unicode till tecken med serverns ACP. SQL Server-tecken, varchar eller textdata som skickas till en klient DBTYPE_STR variabel konverteras från tecken till Unicode med server-ACP och sedan från Unicode till tecken med klient-ACP. Dessa konverteringar utförs på klienten av SQL Server Native Client OLE DB-leverantören. Detta kräver att samma ACP som används på servern är tillgänglig på klienten. Dessa inställningar påverkar inte konverteringarna som sker för dessa överföringar: Unicode DBTYPE_WSTR klientdata som skickas till char, varchar eller text på servern. char-, varchar- eller textserverdata skickade till en Unicode-DBTYPE_WSTR variabel på klienten. ANSI DBTYPE_STR klientdata som skickas till Unicode nchar, nvarchar eller ntext på servern. Unicode-char, varchar- eller textserverdata som skickas till en ANSI-DBTYPE_STR variabel på klienten. VARIANT_FALSE: Den inbyggda klient-OLE DB-leverantören utför inte teckenöversättningar för SQL Server Native Client. Den SQL Server inbyggda klient-OLE DB-leverantören översätter inte klientens ANSI-tecken DBTYPE_STR data som skickas till char, varchar eller textvariabler, parametrar eller kolumner på servern. Ingen översättning utförs på char, varchar eller textdata som skickas från servern till DBTYPE_STR variabler på klienten. Om klienten och instansen av SQL Server använder olika ACP:er kan utökade tecken misstolkas. |
| SSPROP_INIT_CURRENTLANGUAGE | Typ: VT_BSTR R/W: Läs/skriv Beskrivning: Ett SQL Server-språknamn. Identifierar språket som används för val och formatering av systemmeddelanden. Språket måste installeras på datorn som kör en instans av SQL Server, annars misslyckas initialiseringen av datakällan. |
| SSPROP_INIT_DATATYPECOMPATIBILITY | Typ: VT_UI2 R/W: Läs/skriv Standardvärde: 0 Beskrivning: Möjliggör datatypskompatibilitet mellan SQL Server och ActiveX Data Object (ADO)-applikationer. Om standardvärdet 0 används, går datatypen till det som används av leverantören. Om värdet 80 används används endast SQL Server 2000 (8.x) datatyper för datatyper. För mer information, se Att använda ADO med SQL Server Native Client. |
| SSPROP_INIT_ENCRYPT | Typ: VT_BOOL R/W: Läs/Skriv Standard: VARIANT_FALSE Beskrivning: För att kryptera data som går över nätverket sätts SSPROP_INIT_ENCRYPT egenskap till VARIANT_TRUE. Om Enable Protocol Encryption är aktiverad kommer kryptering alltid att ske, oavsett inställningen SSPROP_INIT_ENCRYPT. Om den är avstängd och SSPROP_INIT_ENCRYPT är inställd på VARIANT_TRUE, sker kryptering. Om Aktivera protokollkryptering är avstängt och SSPROP_INIT_ENCRYPT är inställd på VARIANT_FALSE, sker ingen kryptering. |
| SSPROP_INIT_FAILOVERPARTNER | Typ: VT_BSTR R/W: Läs/skriv Beskrivning: Specificerar namnet på failover-partnern för databasspegling. Det är en initialiseringsegenskap och kan endast ställas in före initiering. Efter initieringen returnerar den failover-partnern, om sådan finns, som den primära servern har returnerat. Detta gör det möjligt för en smart applikation att cacha den senast fastställda backup-servern, men sådana applikationer bör vara medvetna om att informationen endast uppdateras när anslutningen först etableras (eller återställs, om den poolas) och kan bli inaktuell för långvariga anslutningar. Efter att anslutningen har upprättats kan applikationen fråga denna attribut för att fastställa identiteten på failover-partnern. Om den primära servern inte har någon failover-partner kommer denna egenskap att returnera en tom sträng. För mer information, se Användning av databasspegling. |
| SSPROP_INIT_FILENAME | Typ: VT_BSTR R/W: Läs/skriv Beskrivning: Specificerar primärfilnamnet på en bifogbar databas. Denna databas är ansluten och blir standarddatabasen för anslutningen. För att använda SSPROP_INIT_FILENAME måste du ange databasens namn som värdet på initialiseringsegenskapen DBPROP_INIT_CATALOG. Om databasnamnet inte finns, letar den efter det primära filnamnet som anges i SSPROP_INIT_FILENAME och bifogar databasen med namnet som anges i DBPROP_INIT_CATALOG. Om databasen tidigare var ansluten ansluter SQL Server den inte igen. |
| SSPROP_INIT_MARSCONNECTION | Typ: VT_BOOL R/W: Läs/skriv Standard: VARIANT_FALSE Beskrivning: Specificerar om Multiple Active Result Sets (MARS) är aktiverade för anslutningen. Detta alternativ måste sättas till sant innan en anslutning till databasen görs. Mer information finns i Använda flera aktiva resultatuppsättningar (MARS). |
| SSPROP_INIT_NETWORKADDRESS | Typ: VT_BSTR R/W: Läs/skriv Beskrivning: Nätverksadressen till servern som kör en instans av SQL Server specificerad av egenskapen DBPROP_INIT_DATASOURCE. |
| SSPROP_INIT_NETWORKLIBRARY | Typ: VT_BSTR R/W: Läs/skriv Beskrivning: Namnet på nätverksbiblioteket (DLL) som används för att kommunicera med en instans av SQL Server. Namnet ska inte innehålla sökvägen eller filnamnets .dll. Standardinställningen kan anpassas med SQL Server Client Configuration Utility. Observera: Endast TCP och namngivna pipor stöds av denna egenskap. Om du använder denna egenskap med ett prefix får du ett dubbelprefix vilket resulterar i ett fel, eftersom egenskapen används för att generera ett prefix internt. |
| SSPROP_INIT_PACKETSIZE | Typ: VT_I4 R/W: Läs/skriv Beskrivning: En nätverkspaketstorlek i bytes. Paketstorleksvärdet måste ligga mellan 512 och 32 767. Standard nätverksstorlek för SQL Server Native Client OLE DB-leverantörens nätverkspaket är 4 096. |
| SSPROP_INIT_TAGCOLUMNCOLLATION | Typ: BOOL R/W: Skriv Standard: FALSE Beskrivning: Används under en databasuppdatering när server-side cursors används. Denna egenskap märker datan med sammanställningsinformation som hämtats från servern istället för kodsidan på klienten. För närvarande används denna egenskap endast av den distribuerade frågeprocessen eftersom den känner till sorteringen av destinationsdata och konverterar den korrekt. |
| SSPROP_INIT_TRUST_SERVER_CERTIFICATE | Typ: VT_BOOL R/W: Läs/skriv Standard: VARIANT_FALSE Beskrivning: Används för att aktivera eller inaktivera validering av servercertifikat. Denna egenskap är läs/skriv, men om du försöker sätta den efter att en anslutning har upprättats kommer det att resultera i ett fel. Denna egenskap ignoreras om klienten är konfigurerad att kräva certifikatvalidering. En applikation kan dock använda den tillsammans med SSPROP_INIT_ENCRYPT för att garantera att dess anslutning till servern är krypterad, även om klienten är konfigurerad att inte kräva kryptering och inget certifikat tillhandahålls på klienten. Klientapplikationer kan fråga denna egenskap efter att en anslutning har öppnats för att fastställa de faktiska krypterings- och valideringsinställningarna som används. Observera: Att använda kryptering utan certifikatvalidering ger delvis skydd mot paketsniffning, men det skyddar inte mot man-in-the-middle-attacker. Det möjliggör helt enkelt kryptering av inloggning och data som skickas till servern utan att validera servercertifikatet. Mer information finns i Använda kryptering utan validering. |
| SSPROP_INIT_USEPROCFORPREP | Typ: VT_I4 R/W: Läs/skriv Standard: SSPROPVAL_USEPROCFORPREP_ON Beskrivning: SQL Server-lagringsproceduren används. Definierar användningen av SQL Server tillfälliga lagrade procedurer för att stödja ICommandPrepare-gränssnittet . Denna egenskap var meningsfull endast vid anslutning till SQL Server 6.5. Egenskapen ignoreras i senare versioner. SSPROPVAL_USEPROCFORPREP_OFF: En tillfällig lagrad procedur skapas inte när ett kommando förbereds. SSPROPVAL_USEPROCFORPREP_ON: En tillfällig lagrad procedur skapas när ett kommando förbereds. De tillfälligt lagrade procedurerna tas bort när sessionen släpps. SSPROPVAL_USEPROCFORPREP_ON_DROP: En tillfällig lagrad propuder skapas när ett kommando förbereds. Proceduren avbryts när kommandot är oförberedt med ICommandPrepare::Unprepare, när ett nytt kommando anges för kommandoobjektet med ICommandText::SetCommandText, eller när alla applikationsreferenser till kommandot släpps. |
| SSPROP_INIT_WSID | Typ: VT_BSTR R/W: Läs/skriv Beskrivning: En sträng som identifierar arbetsstationen. |
I den leverantörsspecifika egenskapsuppsättningen DBPROPSET_SQLSERVERDATASOURCEINFO definierar SQL Server Native Client OLE DB-leverantören de ytterligare egenskaperna; se Data Source Information Properties för mer information.
SQL Server Native Client OLE DB Provider-strängen
SQL Server Native Client OLE DB-leverantören känner igen en ODBC-liknande syntax i leverantörssträngens egenskapsvärden. Egenskapen leverantörssträng anges som värdet på OLE DB-initialiseringsegenskapen DBPROP_INIT_PROVIDERSTRING när en anslutning etableras till OLE DB-datakällan. Denna egenskap specificerar OLE DB-leverantörsspecifika anslutningsdata som krävs för att implementera en anslutning till OLE DB-datakällan. Inom strängen avgränsas elementen med semikolon. Det sista elementet i strängen måste avslutas med ett semikolon. Varje element består av ett nyckelord, ett likhetstecken och det värde som skickas vid initiering. Ett exempel:
Server=MyServer;UID=MyUserName;
Med SQL Server Native Client OLE DB-leverantören behöver konsumenten aldrig använda leverantörssträngsegenskapen. Konsumenten kan ställa in vilken initialiseringsegenskap som helst som återspeglas i leverantörssträngen genom att använda antingen OLE DB eller SQL Server Native Client OLE DB leverantörsspecifika initialiseringsegenskaper.
För en lista över nyckelord som finns tillgängliga i SQL Server Native Client OLE DB-leverantören, se Using Connection String Keywords with SQL Server Native Client.