SQLDriverConnect

A következőkre vonatkozik:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Az SQL Server natív ügyfél ODBC-illesztőprogramja olyan kapcsolati attribútumokat határoz meg, amelyek lecserélik vagy javítják a kapcsolati sztring kulcsszavakat. Számos kapcsolati sztring-kulcsszó alapértelmezett értékeit az SQL Server natív ügyfél ODBC-illesztőprogramja adja meg.

Az SQL Server natív ügyfél ODBC-illesztőprogramjában elérhető kulcsszavak listáját a Kapcsolati sztringszavak használata natív SQL Server-ügyféllelcímű témakörben találja.

További információ az SQL Server kapcsolati attribútumairól és az illesztőprogram alapértelmezett viselkedéséről: SQLSetConnectAttr.

Az SQL Server natív ügyfélre érvényes kapcsolati sztringszavakról a Kapcsolati sztring kulcsszavak használata az SQL Server natív ügyféllelcímű témakörben olvashat.

Ha a SQLDriverConnectDriverCompletion paraméter értéke SQL_DRIVER_PROMPT, SQL_DRIVER_COMPLETE vagy SQL_DRIVER_COMPLETE_REQUIRED, az SQL Server natív ügyfél ODBC-illesztőprogramja a megjelenített párbeszédpanelről kéri le a kulcsszóértékeket. Ha a kulcsszó értéke a kapcsolati sztringben van átadva, és a felhasználó nem módosítja a kulcsszó értékét a párbeszédpanelen, az SQL Server natív ügyfél ODBC-illesztőprogramja a kapcsolati sztring értékét használja. Ha az érték nincs beállítva a kapcsolati sztringben, és a felhasználó nem végez hozzárendelést a párbeszédpanelen, az illesztőprogram az alapértelmezett értéket használja.

SQLDriverConnect érvényes WindowHandle kell kapnia, ha bármely Illesztőprogram-kiegészítés érték megköveteli (vagy megkövetelheti) az illesztőprogram kapcsolati párbeszédpaneljének megjelenítését. Érvénytelen leíró SQL_ERROR ad vissza.

Adja meg a DRIVER vagy A DSN kulcsszavakat. Az ODBC azt állítja, hogy az illesztőprogram a két kulcsszó közül a bal szélsőt használja, és figyelmen kívül hagyja a másikat, ha mindkettő meg van adva. Ha az ILLESZTŐPROGRAM meg van adva, vagy a kettő közül a bal szélső, és a SQLDriverConnectDriverCompletion paraméter értéke SQL_DRIVER_NOPROMPT, a KISZOLGÁLÓ kulcsszóra és a megfelelő értékre van szükség.

Ha SQL_DRIVER_NOPROMPT van megadva, a felhasználói hitelesítési kulcsszavaknak értékekkel kell rendelkeznie. Az illesztőprogram biztosítja, hogy a "Trusted_Connection=yes" sztring, vagy a UID és a PWD kulcsszavak is jelen legyenek.

Ha a DriverCompletion paraméter értéke SQL_DRIVER_NOPROMPT vagy SQL_DRIVER_COMPLETE_REQUIRED, és a nyelv vagy adatbázis a kapcsolati sztringből származik, és érvénytelen, SQLDriverConnect SQL_ERROR ad vissza.

Ha a DriverCompletion paraméter értéke SQL_DRIVER_NOPROMPT vagy SQL_DRIVER_COMPLETE_REQUIRED, és a nyelv vagy az adatbázis az ODBC adatforrásdefinícióiból származik, és érvénytelen, AZ SQLDriverConnect a megadott felhasználói azonosító alapértelmezett nyelvét vagy adatbázisát használja, és visszaadja a SQL_SUCCESS_WITH_INFO.

Ha a DriverCompletion paraméter értéke SQL_DRIVER_COMPLETE vagy SQL_DRIVER_PROMPT, és ha a nyelv vagy adatbázis érvénytelen, SQLDriverConnect visszaküldi a párbeszédpanelt.

Az SQLDriverConnect támogatása magas rendelkezésre álláshoz, vészhelyreállításhoz

A SQLDriverConnect Always On rendelkezésre állási csoportok fürthöz való csatlakozásával kapcsolatos további információkért lásd SQL Server natív ügyféltámogatását a magas rendelkezésre álláshoz, vészhelyreállítási.

Az SQLDriverConnect támogatása egyszerű szolgáltatásnevekhez (SPN-ek)

Az SQLDDriverConnect az ODBC Bejelentkezési párbeszédpanelt fogja használni, amikor a kérés engedélyezve van. Ez lehetővé teszi az egyszerű szolgáltatásnevek megadását az egyszerű kiszolgáló és a feladatátvevő partner számára is.

Az SQLDriverConnect elfogadja az új kapcsolati sztring kulcsszavakat ServerSPN és FeladatátvételpartnerSPN, és felismeri az új kapcsolati attribútumokat SQL_COPT_SS_SERVER_SPN és SQL_COPT_SS_FAILOVER_PARTNER_SPN.

Ha egy kapcsolatattribútum-érték többször van megadva, a programozott módon beállított érték elsőbbséget élvez a DSN és a kapcsolati sztring értékével szemben. A DSN-ben lévő értékek elsőbbséget élveznek egy kapcsolati sztringben lévő értékkel szemben.

A kapcsolat megnyitásakor az SQL Server natív ügyfél beállítja SQL_COPT_SS_MUTUALLY_AUTHENTICATED és SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD a kapcsolat megnyitásához használt hitelesítési módszerre.

További információ az egyszerű szolgáltatásnevekről: egyszerű szolgáltatásnevek (SPN-ek) az ügyfélkapcsolatokban (ODBC).

Példák

Az alábbi hívás az SQLDriverConnectszükséges legkisebb adatmennyiséget mutatja be:

SQLDriverConnect(hdbc, hwnd,  
    (SQLTCHAR*) TEXT("DRIVER={SQL Server Native Client 10};"), SQL_NTS, szOutConn,  
    MAX_CONN_OUT, &cbOutConn, SQL_DRIVER_COMPLETE);  

Az alábbi kapcsolati sztringek a minimálisan szükséges adatokat szemléltetik, ha a DriverCompletion paraméter értéke SQL_DRIVER_NOPROMPT:

"DSN=Human Resources;Trusted_Connection=yes"  
  
"FILEDSN=HR_FDSN;Trusted_Connection=yes"  
  
"DRIVER={SQL Server Native Client 10};SERVER=(local);Trusted_Connection=yes"  

Lásd még:

SQLDriverConnect-függvény
ODBC API implementálásának részletei
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING (Transact-SQL)
SET ANSI_WARNINGS (Transact-SQL)