Fungsi SQLPoolConnect

Kesesuaian
Versi diperkenalkan: Kepatuhan Standar ODBC 3.8: ODBC

Ringkasan
SQLPoolConnect digunakan untuk membuat koneksi baru jika tidak ada koneksi di kumpulan yang dapat digunakan kembali.

Sintaks

  
SQLRETURN  SQLPoolConnect(  
                SQLHDBC              hDbc,  
                SQLHDBC_INFO_TOKEN   hDbcInfoToken,  
                WCHAR *              wszOutConnectString,  
                SQLSMALLINT          cchConnectStringBuffer,  
                SQLSMALLINT *        cchConnectStringLen );  

Argumen

hDbc
[Input] Handel koneksi.

hDbcInfoToken
[Input] Handel token untuk permintaan koneksi aplikasi baru.

wszOutConnectString
[Output] Penunjuk ke buffer untuk string koneksi yang telah selesai. Setelah koneksi berhasil ke sumber data target, buffer ini berisi string koneksi yang selesai. Aplikasi harus mengalokasikan setidaknya 1.024 karakter untuk buffer ini.

Jika wszOutConnectString ADALAH NULL, cchConnectStringLen masih akan mengembalikan jumlah total karakter (tidak termasuk karakter penghentian null untuk data karakter) yang tersedia untuk dikembalikan dalam buffer yang ditujukkan oleh wszOutConnectString.

cchConnectStringBuffer
[Input] Panjang buffer *wszOutConnectString , dalam karakter.

cchConnectStringLen
[Output] Pointer ke buffer untuk mengembalikan jumlah total karakter (tidak termasuk karakter null-termination) yang tersedia untuk dikembalikan dalam *wszOutConnectString. Jika jumlah karakter yang tersedia untuk dikembalikan lebih besar dari atau sama dengan cchConnectStringBuffer, string koneksi yang diselesaikan di *wszOutConnectString dipotong ke cchConnectStringBuffer dikurangi panjang karakter null-termination.

Mengembalikan

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR, atau, SQL_INVALID_HANDLE.

Diagnostik

Mirip dengan SQLDriverConnect untuk kesalahan validasi input apa pun, kecuali bahwa Manajer Driver akan menggunakan HandleType SQL_HANDLE_DBC_INFO_TOKEN dan HandelhDbcInfoToken.

Keterangan

Driver Manager menjamin bahwa handel HENV induk hDbc dan hDbcInfoToken sama.

Tidak seperti SQLDriverConnect, tidak ada argumen DriverCompletion untuk meminta pengguna memasukkan informasi koneksi. Dialog permintaan tidak diizinkan dalam skenario pengumpulan.

Aplikasi tidak boleh memanggil fungsi ini secara langsung. Driver ODBC yang mendukung pengumpulan koneksi sadar driver harus menerapkan fungsi ini.

Setiap kali driver kembali SQL_ERROR atau SQL_INVALID_HANDLE, Manajer Driver mengembalikan kesalahan ke aplikasi (di SQLConnect atau SQLDriverConnect).

Setiap kali driver kembali SQL_SUCCESS_WITH_INFO, Manajer Driver akan mendapatkan informasi diagnostik dari hDbcInfoToken, dan mengembalikan SQL_SUCCESS_WITH_INFO ke aplikasi di SQLConnect dan SQLDriverConnect.

Ketika aplikasi menggunakan SQLConnect, wszOutConnectString akan menjadi buffer NULL (tiga parameter terakhir semuanya akan diatur ke NULL, 0, NULL). Jika tidak, driver harus mengembalikan string koneksi output, yang akan dikembalikan ke panggilan Fungsi SQLDriverConnect aplikasi.

Sertakan sqlspi.h untuk pengembangan driver ODBC.

Lihat juga

Mengembangkan Driver ODBC
Pengumpulan Koneksi yang Sadar Driver
Mengembangkan kesadaran Connection-Pool dalam Driver ODBC