Fungsi SQLGetPoolID

  • Artikel

Kesesuaian
Versi Diperkenalkan: Kepatuhan Standar ODBC 3.81: ODBC

Ringkasan
SQLGetPoolID mengambil ID kumpulan.

Sintaks

  
SQLRETURN  SQLGetPoolID (  
                SQLHDBC_INFO_TOKEN    hDbcInfoToken,  
                POOLID *              pPoolID );

Argumen

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

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

Kembali

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR, atau SQL_INVALID_HANDLE.

Diagnostik

Ketika SQLGetPoolID mengembalikan SQL_ERROR atau SQL_SUCCESS_WITH_INFO, Manajer Driver akan menggunakan HandleType SQL_HANDLE_DBC_INFO_TOKEN dan HandelhDbcInfoToken.

Keterangan

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

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

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

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

Sertakan sqlspi.h untuk pengembangan driver ODBC.

Lihat Juga

Mengembangkan Driver ODBC
Pengumpulan Koneksi Sadar Driver
Mengembangkan Kesadaran Kumpulan Koneksi di Driver ODBC