Fungsi SQLGetPoolID

Kesesuaian
Versi yang diperkenalkan: Kepatuhan standar ODBC 3.81: ODBC

Summary
SQLGetPoolID mengambil ID pool.

Syntax

  
SQLRETURN  SQLGetPoolID (  
                SQLHDBC_INFO_TOKEN    hDbcInfoToken,  
                POOLID *              pPoolID );

Arguments

hDbcInfoToken
[Input] Handle token yang berisi semua informasi koneksi.

pPoolID
[Output] ID pool, yang digunakan untuk mengidentifikasi sekumpulan koneksi yang dapat digunakan secara bergantian (mungkin memerlukan reset tambahan).

Returns

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR, atau SQL_INVALID_HANDLE.

Diagnostics

Ketika SQLGetPoolID mengembalikan SQL_ERROR atau SQL_SUCCESS_WITH_INFO, Driver Manager akan menggunakan HandleType dari SQL_HANDLE_DBC_INFO_TOKEN dan Handledari hDbcInfoToken.

Remarks

SQLGetPoolID digunakan untuk memperoleh ID pool berdasarkan serangkaian informasi koneksi (dari SQLSetConnectAttrForDbcInfo, SQLSetDriverConnectInfo, dan SQLSetConnectInfo). ID pool ini digunakan untuk mengidentifikasi sekumpulan koneksi yang dapat digunakan secara bergantian (mungkin memerlukan reset tambahan). ID pool akan digunakan untuk mengidentifikasi pool koneksi untuk grup koneksi tersebut.

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.

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

Sertakan sqlspi.h untuk pengembangan driver ODBC.

Konten terkait

  • Last updated on