SQLDriverConnect

Berlaku untuk:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System (PDW)

Driver ODBC Klien Asli SQL Server menentukan atribut koneksi yang menggantikan atau meningkatkan kata kunci string koneksi. Beberapa kata kunci string koneksi memiliki nilai default yang ditentukan oleh driver ODBC SQL Server Native Client.

Untuk daftar kata kunci yang tersedia di driver ODBC SQL Server Native Client, lihat Menggunakan Kata Kunci String Koneksi ion dengan Klien Asli SQL Server.

Untuk informasi selengkapnya tentang atribut koneksi SQL Server dan perilaku default driver, lihat SQLSet Koneksi Attr.

Untuk diskusi string koneksi kata kunci yang valid untuk Klien Asli SQL Server, lihat Menggunakan Kata Kunci String Koneksi ion dengan Klien Asli SQL Server.

Saat nilai parameter SQLDriver Koneksi DriverCompletion SQL_DRIVER_PROMPT, SQL_DRIVER_COMPLETE, atau SQL_DRIVER_COMPLETE_REQUIRED, driver ODBC Klien Asli SQL Server mengambil nilai kata kunci dari kotak dialog yang ditampilkan. Jika nilai kata kunci diteruskan dalam string koneksi dan pengguna tidak mengubah nilai untuk kata kunci dalam kotak dialog, driver ODBC Klien Asli SQL Server menggunakan nilai dari string koneksi. Jika nilai tidak diatur dalam string koneksi dan pengguna tidak membuat penugasan dalam kotak dialog, driver menggunakan default.

SQLDriver Koneksi harus diberi WindowHandle yang valid ketika nilai DriverCompletion memerlukan (atau mungkin memerlukan) tampilan kotak dialog koneksi driver. Handel yang tidak valid mengembalikan SQL_ERROR.

Tentukan kata kunci DRIVER atau DSN. ODBC menyatakan bahwa driver menggunakan yang paling kiri dari dua kata kunci ini dan mengabaikan yang lain jika keduanya ditentukan. Jika DRIVER ditentukan, atau merupakan yang paling kiri dari keduanya, dan nilai parameter SQLDriver Koneksi DriverCompletion SQL_DRIVER_NOPROMPT, kata kunci SERVER dan nilai yang sesuai diperlukan.

Ketika SQL_DRIVER_NOPROMPT ditentukan, kata kunci autentikasi pengguna harus ada dengan nilai. Driver memastikan bahwa string "Trusted_Koneksi ion=yes" atau kata kunci UID dan PWD ada.

Jika nilai parameter DriverCompletion SQL_DRIVER_NOPROMPT atau SQL_DRIVER_COMPLETE_REQUIRED dan bahasa atau database berasal dari string koneksi dan salah satunya tidak valid, SQLDriver Koneksi mengembalikan SQL_ERROR.

Jika nilai parameter DriverCompletion SQL_DRIVER_NOPROMPT atau SQL_DRIVER_COMPLETE_REQUIRED dan bahasa atau database berasal dari definisi sumber data ODBC dan tidak valid, SQLDriver Koneksi menggunakan bahasa atau database default untuk ID pengguna yang ditentukan dan mengembalikan SQL_SUCCESS_WITH_INFO.

Jika nilai parameter DriverCompletion SQL_DRIVER_COMPLETE atau SQL_DRIVER_PROMPT dan jika bahasa atau database tidak valid, SQLDriver Koneksi memutar ulang kotak dialog.

Dukungan SQLDriver Koneksi untuk Ketersediaan Tinggi, Pemulihan Bencana

Untuk informasi selengkapnya tentang menggunakan SQLDriver Koneksi untuk menyambungkan ke kluster grup ketersediaan AlwaysOn, lihat Dukungan Klien Asli SQL Server untuk Ketersediaan Tinggi, Pemulihan Bencana.

Dukungan SQLDriver Koneksi untuk Nama Perwakilan Layanan (SPN)

SQLDDriver Koneksi akan menggunakan kotak dialog Masuk ODBCsaat meminta diaktifkan. Ini memungkinkan SPN dimasukkan untuk server utama dan mitra failover-nya.

SQLDriver Koneksi akan menerima kata kunci string koneksi baru ServerSPN dan FailoverPartnerSPN, dan akan mengenali atribut koneksi baru SQL_COPT_SS_SERVER_SPN dan SQL_COPT_SS_FAILOVER_PARTNER_SPN.

Ketika nilai atribut koneksi ditentukan lebih dari sekali, nilai yang ditetapkan secara terprogram lebih diutamakan daripada nilai dalam DSN dan nilai dalam string koneksi. Nilai dalam DSN lebih diutamakan daripada nilai dalam string koneksi.

Saat koneksi dibuka, SQL Server Native Client mengatur SQL_COPT_SS_MUTUALLY_AUTHENTICATED dan SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD ke metode autentikasi yang digunakan untuk membuka koneksi.

Untuk informasi selengkapnya tentang SPN, lihat Nama Perwakilan Layanan (SPN) di Koneksi ion Klien (ODBC).

Contoh

Panggilan berikut mengilustrasikan jumlah data paling sedikit yang diperlukan untuk SQLDriver Koneksi:

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

String koneksi berikut mengilustrasikan data minimum yang diperlukan saat nilai parameter 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"  

Lihat Juga

Fungsi SQLDriver Koneksi
Detail Implementasi ODBC API
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING (Transact-SQL)
SET ANSI_WARNINGS (Transact-SQL)