Fungsi SQLCleanupConnectionPoolID

Artikel
08/21/2023

Kesesuaian
Versi Diperkenalkan: Kepatuhan Standar ODBC 3.81: ODBC

Ringkasan
SQLCleanupConnectionPoolID memberi tahu driver bahwa ID kumpulan kehabisan waktu. ID kumpulan dapat kehabisan waktu setiap kali semua koneksi dalam kumpulan yang terkait dengan ID kumpulan tersebut kehabisan waktu. Lihat Pengumpulan di Komponen Akses Data Microsoft untuk informasi selengkapnya tentang batas waktu koneksi.

Sintaks

  
SQLRETURN  SQLCleanupConnectionPoolID (  
                SQLHENV    EnvironmentHandle  
                SQLPOOLID  PoolID );

Argumen

EnvironmentHandle
[Input] Handel lingkungan kumpulan.

PoolID
[Input] Kumpulan yang terkait dengan ID kumpulan yang kehabisan waktu.

Kembali

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR, atau SQL_INVALID_HANDLE.

Diagnostik

Manajer Driver tidak akan memproses informasi diagnostik yang dikembalikan dari SQLCleanupConnectionPoolID.

Aplikasi tidak dapat menerima pesan kesalahan yang dikembalikan oleh driver.

Keterangan

SQLCleanupConnectionPoolID dapat dipanggil kapan saja, tetapi Manajer Driver menjamin bahwa tidak ada utas lain yang secara bersamaan memanggil SQLGetPoolID dan tidak ada utas lain yang secara bersamaan memanggil SQLRateConnection dan SQLPoolConnect dengan token info koneksi yang ditetapkan dengan ID kumpulan tersebut. Oleh karena itu, driver harus memastikan fungsi ini aman utas.

Driver dapat membersihkan sumber daya yang terkait dengan ID kumpulan.

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

Bagikan melalui