Fungsi SQLPoolConnect

Kesesuaian
Versi yang diperkenalkan: Kepatuhan standar ODBC 3.8: ODBC

Summary
SQLPoolConnect digunakan untuk membuat koneksi baru jika tidak ada koneksi di pool yang dapat digunakan kembali.

Syntax

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

Arguments

hDbc
[Input] Handle koneksi.

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

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

Jika wszOutConnectString bernilai NULL, cchConnectStringLen tetap akan mengembalikan total jumlah karakter (tidak termasuk karakter null-terminasi untuk data karakter) yang tersedia untuk dikembalikan di buffer yang ditunjuk oleh wszOutConnectString.

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

cchConnectStringLen
[Output] Penunjuk ke buffer untuk mengembalikan total jumlah karakter (tidak termasuk karakter null-terminasi) yang tersedia untuk dikembalikan dalam *wszOutConnectString. Jika jumlah karakter yang tersedia untuk dikembalikan lebih besar atau sama dengan cchConnectStringBuffer, string koneksi yang telah selesai di *wszOutConnectString akan dipotong menjadi cchConnectStringBuffer dikurangi panjang karakter null-terminasi.

Returns

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR, atau, SQL_INVALID_HANDLE.

Diagnostics

Mirip dengan SQLDriverConnect untuk kesalahan validasi input apa pun, kecuali Driver Manager akan menggunakan HandleType dari SQL_HANDLE_DBC_INFO_TOKEN dan Handledari hDbcInfoToken.

Remarks

Driver Manager menjamin bahwa handle HENV induk hDbc dan hDbcInfoToken adalah sama.

Berbeda dengan SQLDriverConnect, tidak ada argumen DriverCompletion untuk meminta pengguna memasukkan informasi koneksi. Dialog prompting tidak diperbolehkan dalam skenario pooling.

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

Setiap kali driver mengembalikan SQL_ERROR atau SQL_INVALID_HANDLE, Driver Manager mengembalikan error ke aplikasi (di SQLConnect atau SQLDriverConnect).

Setiap kali driver mengembalikan SQL_SUCCESS_WITH_INFO, Driver Manager akan memperoleh informasi diagnostik dari hDbcInfoToken, dan mengembalikan SQL_SUCCESS_WITH_INFO ke aplikasi dalam SQLConnect dan SQLDriverConnect.

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

Sertakan sqlspi.h untuk pengembangan driver ODBC.

Konten terkait

  • Last updated on