SQLDriverConnect

platí pro:SQL ServerAzure SQL Databaseazure SQL Managed InstanceAzure Synapse AnalyticsPlatform Platform System (PDW)

Ovladač ODBC nativního klienta SQL Serveru definuje atributy připojení, které nahrazují nebo vylepšují klíčová slova připojovacího řetězce. Několik klíčových slov připojovacího řetězce má výchozí hodnoty určené ovladačem ODBC nativního klienta SQL Serveru.

Seznam klíčových slov dostupných v ovladači ODBC nativního klienta SYSTÉMU SQL Server naleznete v tématu Použití klíčových slov připojovacího řetězce s nativním klientem SQL Serveru.

Další informace o atributech připojení SYSTÉMU SQL Server a výchozí chování ovladače naleznete v tématu SQLSetConnectAttr.

Diskuzi o klíčových slovech připojovacího řetězce, která jsou platná pro sql Server Native Client, naleznete v tématu Použití klíčových slov připojovacího řetězce s SQL Server Native Client.

Pokud je hodnota parametru SQLDriverConnectDriverCompletion SQL_DRIVER_PROMPT, SQL_DRIVER_COMPLETE nebo SQL_DRIVER_COMPLETE_REQUIRED, ovladač ODBC nativního klienta SQL Serveru načte hodnoty klíčových slov ze zobrazeného dialogového okna. Pokud je hodnota klíčového slova předána v připojovacím řetězci a uživatel nezmění hodnotu klíčového slova v dialogovém okně, ovladač ODBC nativního klienta SQL Serveru použije hodnotu z připojovacího řetězce. Pokud hodnota není nastavena v připojovacím řetězci a uživatel v dialogovém okně nepřiřazuje žádné přiřazení, ovladač použije výchozí hodnotu.

sqlDriverConnect musí být udělen platný WindowHandle, pokud jakákoli hodnota DriverCompletion vyžaduje (nebo může vyžadovat) zobrazení dialogového okna připojení ovladače. Neplatný popisovač vrátí SQL_ERROR.

Zadejte klíčová slova DRIVER nebo DSN. ODBC uvádí, že ovladač používá nejvíce vlevo od těchto dvou klíčových slov a ignoruje druhý, pokud jsou zadány oba. Pokud je zadán ovladač nebo je vlevo od dvou a SQLDriverConnectDriverCompletion hodnota parametru je SQL_DRIVER_NOPROMPT, klíčové slovo SERVER a příslušná hodnota jsou povinné.

Při zadání SQL_DRIVER_NOPROMPT musí být klíčová slova ověřování uživatelů přítomna s hodnotami. Ovladač zajišťuje, že se nachází buď řetězec "Trusted_Connection=yes", nebo jak klíčové slovo UID, tak PWD.

Pokud je hodnota parametru DriverCompletion SQL_DRIVER_NOPROMPT nebo SQL_DRIVER_COMPLETE_REQUIRED a jazyk nebo databáze pochází z připojovacího řetězce a je neplatný, sqlDriverConnect vrátí SQL_ERROR.

Pokud je hodnota parametru DriverCompletion SQL_DRIVER_NOPROMPT nebo SQL_DRIVER_COMPLETE_REQUIRED a jazyk nebo databáze pochází z definic zdrojů dat ODBC a buď je neplatná, SQLDriverConnect použije výchozí jazyk nebo databázi pro zadané ID uživatele a vrátí SQL_SUCCESS_WITH_INFO.

Pokud je hodnota parametru DriverCompletion SQL_DRIVER_COMPLETE nebo SQL_DRIVER_PROMPT a pokud je jazyk nebo databáze neplatná, sqlDriverConnect dialogové okno znovu zobrazí.

Podpora služby SQLDriverConnect pro zajištění vysoké dostupnosti, zotavení po havárii

Další informace o použití SQLDriverConnect pro připojení ke clusteru skupin dostupnosti AlwaysOn naleznete v tématu sql Server Native Client Support for High Availability, Disaster Recovery.

Podpora služby SQLDriverConnect pro hlavní názvy služeb (SPN)

SQLDDriverConnect použije dialogové okno pro přihlášení ODBC při zobrazení výzvy. To umožňuje zadat hlavní server i partnera pro převzetí služeb při selhání.

SQLDriverConnect přijme nová klíčová slova připojovacího řetězce ServerSPN a FailoverPartnerSPNa rozpozná nové atributy připojení SQL_COPT_SS_SERVER_SPN a SQL_COPT_SS_FAILOVER_PARTNER_SPN.

Pokud je hodnota atributu připojení zadána více než jednou, má hodnota nastavená programově přednost před hodnotou v DSN a hodnotou v připojovacím řetězci. Hodnota v DSN má přednost před hodnotou v připojovacím řetězci.

Při otevření připojení sql Server Native Client nastaví SQL_COPT_SS_MUTUALLY_AUTHENTICATED a SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD na metodu ověřování použitou k otevření připojení.

Další informace o hlavních názvech služby najdete v tématu hlavní názvy služby (SPN) vklientská připojení (ODBC).

Příklady

Následující volání ukazuje nejmenší množství dat vyžadovaných pro SQLDriverConnect:

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

Následující připojovací řetězce znázorňují minimální požadovaná data, pokud je hodnota parametru DriverCompletion 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"  

Viz také

funkce SQLDriverConnect
podrobnosti implementace rozhraní ODBC API
ANSI_NULLS ANSI_NULLS set (Transact-SQL)
ANSI_PADDING SET (Transact-SQL)
ANSI_WARNINGS SET (Transact-SQL)