SQLDriverConnect
SQL ServerYerel istemci odbc sürücüsü değiştirebilir veya bağlantı dizesi anahtar sözcükler geliştirmek bağlantı özniteliklerini tanımlar. Birkaç bağlantı dizesi anahtar kelimeler tarafından belirtilen varsayılan değerlere sahip SQL Serveryerel istemci odbc sürücüsü.
Kullanılabilir anahtar sözcükler listesi için SQL Serverbkz: yerel istemci odbc sürücüsü, SQL Server ile yerel istemci bağlantı dizesi anahtar sözcükler kullanma.
Hakkında daha fazla bilgi için SQL Serverbağlantı özniteliklerini ve sürücü varsayılan davranışları, SQLSetConnectAttr.
Geçerli bağlantı dizesi anahtar sözcükler bir tartışma SQL ServerYerel bkz: istemci, SQL Server ile yerel istemci bağlantı dizesi anahtar sözcükler kullanma.
Ne zaman SQLDriverConnectDriverCompletion parametre değeri ise SQL_DRIVER_PROMPT, SQL_DRIVER_COMPLETE veya SQL_DRIVER_COMPLETE_REQUIRED, SQL Serveryerel istemci odbc sürücüsü, görüntülenen iletişim kutusunda anahtar değerleri alır. Anahtar sözcük değeri bağlantı dizesinde geçirilir ve kullanıcı iletişim kutusunda, anahtar değeri değiştirmez SQL Serveryerel istemci odbc sürücüsü kullanan bağlantı dizesi değeri. Değer bağlantı dizesinde ayarlanmamıştır ve kullanıcı iletişim kutusunda hiçbir atama yapar, sürücü varsayılan kullanır.
SQLDriverConnect geçerli bir verilmelidir WindowHandle zaman herhangi bir DriverCompletion değeri gerektirir (veya gerektirebilir) sürücü bağlantısı iletişim kutusunu görüntüleme. Geçersiz bir tanıtıcı sql_error döndürür.
SÜRÜCÜ veya dsn anahtar sözcükleri belirtin. odbc sürücü soldaki bu iki anahtar kullanır ve her ikisi de belirtilirse diğer yoksayar devletler. SÜRÜCÜ belirtilirse veya soldaki iki ve SQLDriverConnectDriverCompletion parametre değeri SQL_DRIVER_NOPROMPT, sunucu anahtar ve uygun bir değer gerekli.
SQL_DRIVER_NOPROMPT belirtilmişse, kullanıcı kimlik doğrulama anahtar değerleri ile mevcut olmalıdır. Sürücü, iki dizeyi sağlar "Trusted_Connection = yes" veya UID ve pwd anahtar yok.
Eğer DriverCompletion parametre değeri SQL_DRIVER_NOPROMPT veya SQL_DRIVER_COMPLETE_REQUIRED ve dil veya veritabanı bağlantı dizesi geliyor ve ya da geçersiz, SQLDriverConnect sql_error döndürür.
Eğer DriverCompletion parametre değeri SQL_DRIVER_NOPROMPT olduğunu veya SQL_DRIVER_COMPLETE_REQUIRED ve dil veya veritabanı odbc veri kaynağı tanımları gelir ve ya da geçersiz SQLDriverConnect varsayılan dil veya veritabanı için belirtilen kullanıcı kimliğini kullanır ve SQL_SUCCESS_WITH_INFO döndürür.
Eğer DriverCompletion parametre değeri ise SQL_DRIVER_COMPLETE ya da SQL_DRIVER_PROMPT ve dil veya veritabanı geçersiz ise SQLDriverConnect iletişim kutusunu görüntüler.
Olağanüstü durum kurtarma, yüksek kullanılabilirlik için SQLDriverConnect desteği
Kullanma hakkında daha fazla bilgi için SQLDriverConnect bağlanmak için bir AlwaysOn Kullanılabilirlik Gruplarıbkz: Küme Olağanüstü durum kurtarma, yüksek kullanılabilirlik için SQL Server yerel istemci desteği.
Hizmet asıl adlarını (SPN) için SQLDriverConnect desteği
SQLDDriverConnectodbc iletişim boxwhen isteyen etkin oturumu kullanır. Bu, hem asıl sunucu hem de onun yerine çalışma ortağı için girilecek SPN'ler sağlar.
SQLDriverConnectYeni bağlantı dizesi anahtar sözcükler kabul ServerSPNve FailoverPartnerSPNve yeni bağlantı özniteliklerini sql_copt_ss_server_spn ve SQL_COPT_SS_FAILOVER_PARTNER_SPN tanımaz.
Birden fazla bağlantı öznitelik değeri belirtildiğinde, programlı olarak ayarlanmış bir değeri bir dsn değeri ve bir bağlantı dizesi değer önceliklidir. dsn değer bir bağlantı dizesi değeri daha önceliklidir.
Bir bağlantı açıldığında, SQL Serveryerel istemci bağlantıyı açmak için kullanılan kimlik doğrulama yöntemi SQL_COPT_SS_MUTUALLY_AUTHENTICATED ve SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD ayarlar.
SPN'ler hakkında daha fazla bilgi için bkz: Istemci bağlantıları (odbc)'nda hizmet asıl adı (SPN).
Örnekler
Aşağıdaki arama için gerekli veri en az tutarı gösterilmiştir SQLDriverConnect:
SQLDriverConnect(hdbc, hwnd,
(SQLTCHAR*) TEXT("DRIVER={SQL Server Native Client 10};"), SQL_NTS, szOutConn,
MAX_CONN_OUT, &cbOutConn, SQL_DRIVER_COMPLETE);
SQLDriverConnect(hdbc, hwnd,
(SQLTCHAR*) TEXT("DRIVER={SQL Server Native Client 10};"), SQL_NTS, szOutConn,
MAX_CONN_OUT, &cbOutConn, SQL_DRIVER_COMPLETE);
Aşağıdaki bağlantı dizeleri en az gerekli verileri göstermek ne zaman DriverCompletion parametre değeri SQL_DRIVER_NOPROMPT 's:
"DSN=Human Resources;Trusted_Connection=yes"
"FILEDSN=HR_FDSN;Trusted_Connection=yes"
"DRIVER={SQL Server Native Client 10};SERVER=(local);Trusted_Connection=yes"
"DSN=Human Resources;Trusted_Connection=yes"
"FILEDSN=HR_FDSN;Trusted_Connection=yes"
"DRIVER={SQL Server Native Client 10};SERVER=(local);Trusted_Connection=yes"
Ayrıca bkz.
Başvuru
set ANSI_PADDING (Transact-sql)
set ANSI_WARNINGS (Transact-sql)