SQLDriverConnect
The SQL Server Native Client ODBC driver defines connection attributes that either replace or enhance connection-string keywords.Birkaç bağlantı -dize anahtar sözcükler tarafından belirtilen varsayılan değerlere sahip SQL Server yerel istemci odbc sürücüsü.
Kullanılabilir anahtar sözcükler listesi için SQL Server yerel istemci odbc sürücüsü, bkz: SQL Server ile yerel istemci bağlantı dizesi anahtar sözcükler kullanma.
Hakkında daha fazla bilgi için SQL Server Bkz: bağlantı özniteliklerini ve sürücü varsayılan davranışları, SQLSetConnectAttr.
Bağlantı bir tartışma için dize için geçerli anahtar sözcükler SQL Server Native Client, bkz: SQL Server ile yerel istemci bağlantı dizesi anahtar sözcükler kullanma.
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 bağlantı verilmezse, dize kullanıcı iletişim kutusunda anahtar sözcük değeri değiştirmez ve SQL Server yerel istemci odbc sürücüsü kullanan bağlantı değeri dize.Bağlantı değeri ayarlanırsa, dize ve kullanıcı iletişim kutusunda hiçbir atama yapar, varsayılan sürücü kullanır.
SQLDriverConnect geçerli bir verilmesi gereken WindowHandle herhangi zaman DriverCompletion değeri gerektirir (veya gerektirebilir) sürücünün bağlantısı iletişim kutusundaki görüntüle.Geçersiz bir tanıtıcı SQL_ERROR hatası 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 belirtmektedir.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 komutuna belirtilmişse, kullanıcı kimlik doğrulaması anahtar değerleriyle bulunması gerekir.Sürücü, dize sağlar "Trusted_Connection = yes" veya UID ve pwd anahtar sözcükleri bulunmaktadır.
If the DriverCompletion parameter value is SQL_DRIVER_NOPROMPT or SQL_DRIVER_COMPLETE_REQUIRED and the language or database comes from the connection string 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 source definitions and either is invalid, SQLDriverConnect uses the default language 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 adlarını (SPN) için SQLDriverConnect desteği
SQLDDriverConnect odbc iletişim boxwhen isteyen etkin oturumu kullanır.Bu asıl sunucu ve onun yerine çalışma ortak için girilecek SPN'ler sağlar.
SQLDriverConnectyeni bağlantıyı kabul eder dize anahtar sözcükler ServerSPN ve FailoverPartnerSPN, yeni bağlantı özniteliklerini sql_copt_ss_server_spn ve SQL_COPT_SS_FAILOVER_PARTNER_SPN. tanır ve
Birden fazla bağlantı öznitelik değeri belirtildiğinde, programlı olarak küme bir değeri bir dsn değeri ve bir bağlantı değer önceliklidir dize.dsn değerinde bir bağlantıda bir değer önceliklidir dize.
Bir bağlantı açıldığında, SQL Server SQL_COPT_SS_MUTUALLY_AUTHENTICATED ve SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD açma kullanılan kimlik doğrulaması yöntem için Native Client ayarlarbağlantısı.
SPN'ler hakkında daha fazla bilgi için bkz: İstemci bağlantıları (odbc)'nda hizmet asıl adlarını (SPN).
Örnekler
Veri için gereken en az miktarda şu çağrı 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);
En az gerekli veriler aşağıdaki bağlantı dizeleri göstermek, DriverCompletion parametre değeri SQL_DRIVER_NOPROMPT komutuna ise:
"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.