SQLDriverConnect
The SQL Server Native istemci ODBC driver defines connection attributes that either replace or enhance connection-dize keywords. Birden çok bağlantı-dize anahtar tarafından belirtilen varsayılan değerleriniz SQL Server Yerel istemci ODBC sürücüsü.
Kullanılabilir anahtar sözcüklerin listesi için SQL Server Yerel istemci ODBC sürücüsü için bkz: SQL Server ile yerel istemci bağlantı dizesi anahtar sözcükler kullanma.
Daha fazla bilgi için SQL Server bağlantı özniteliklerini ve sürücü varsayılan davranışları için bkz: SQLSetConnectAttr.
When the SQLDriverConnectDriverCompletion parameter value is SQL_DRIVER_PROMPT, SQL_DRIVER_COMPLETE, or SQL_DRIVER_COMPLETE_REQUIRED, the SQL Server Native Client ODBC driver retrieves keyword values from the displayed dialog box.Anahtar sözcük değeri de geçirilir, bağlantı dizesi ve kullanıcı iletişim kutusunda, anahtar değeri değiştirmez SQL Server Değeri yerel istemci ODBC sürücüsü kullanan bağlantı dizesi. Değerin ayarlanması, bağlantı dizesi ve kullanıcı iletişim kutusunda yok atama yaptığı için varsayılan sürücü kullanır.
SQLDriverConnect geçerli bir verilmelidir.WindowHandle when any DriverCompletion değeri gerektirir (veya gerektirebilir), sürücünün 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ü, bu iki anahtar sözcüklerin en soldaki kullanır ve her ikisi de belirtilirse diğer yoksayar belirtir.If DRIVER is specified, or is the leftmost of the two, and the SQLDriverConnectDriverCompletion parameter value is SQL_DRIVER_NOPROMPT, the SERVER keyword and an appropriate value are required.
SQL_DRIVER_NOPROMPT belirtilmişse, kullanıcı kimlik doğrulaması anahtar değerleriyle bulunması gerekir.Sürücü, dize ya da sağlar "Trusted_Connection = yes" ya da UID ve PWD anahtar sözcükleri bulunur.
If the DriverCompletion parameter value is SQL_DRIVER_NOPROMPT or SQL_DRIVER_COMPLETE_REQUIRED and the language or database comes from the connection dize and either is invalid, SQLDriverConnect returns SQL_ERROR.
If the DriverCompletion parameter value is SQL_DRIVER_NOPROMPT or SQL_DRIVER_COMPLETE_REQUIRED and the language or database comes from the ODBC data kaynak definitions and either is invalid, SQLDriverConnect uses the varsayılan dil or database for the specified user ID and returns SQL_SUCCESS_WITH_INFO.
If the DriverCompletion parameter value is SQL_DRIVER_COMPLETE or SQL_DRIVER_PROMPT and if the language or database is invalid, SQLDriverConnect redisplays the dialog box.
Hizmet asıl adı (SPN) SQLDriverConnect desteği
SQLDDriverConnect ODBC iletişim boxwhen isteyen etkin oturum açma kullanır.Bu asıl sunucu ve onun yerine çalışma ortağı için girilecek SPN sağlar.
SQLDriverConnect Yeni kabul bağlantı dizesi anahtar sözcükleri ServerSPN ve FailoverPartnerSPNve yeni bağlantı özniteliklerini SQL_COPT_SS_SERVER_SPN ve SQL_COPT_SS_FAILOVER_PARTNER_SPN algılar.
Bir Bağlantı öznitelik değeri birden fazla defa belirtildiğinde, programlı olarak küme bir değeri bir DSN alanındaki ve bir bağlantıda bir değer önceliklidir dize.Değer bir DSN bir bağlantı dizesi değeri daha önceliklidir.
Bağlantı, açıldığında SQL Server Yerel istemci SQL_COPT_SS_MUTUALLY_AUTHENTICATED ve SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD, bağlantıyı açmak için kullanılan kimlik doğrulaması yöntem için ayarlar.
SPN hakkında daha fazla bilgi için bkz: Hizmet asıl adı (SPN) istemci bağlantıları'nı (ODBC).
Örnekler
Aşağıdaki arama en az gereken veri miktarını gösterir. SQLDriverConnect:
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 veriler göstermek, DriverCompletion SQL_DRIVER_NOPROMPT parametre değeridir:
"DSN=Human Resources;Trusted_Connection=yes"
"FILEDSN=HR_FDSN;Trusted_Connection=yes"
"DRIVER={SQL Server Native Client 10};SERVER=(local);Trusted_Connection=yes"
See Also