Fungsi SQLCleanupConnectionPoolID

Kesesuaian
Versi yang diperkenalkan: Kepatuhan standar ODBC 3.81: ODBC

Summary
SQLCleanupConnectionPoolID memberi tahu driver bahwa ID pool telah habis waktu. ID pool dapat timeout setiap kali semua koneksi dalam pool yang terkait dengan ID pool tersebut habis waktu. Lihat Pooling di Microsoft Data Access Components untuk informasi lebih lanjut tentang timeout koneksi.

Syntax

  
SQLRETURN  SQLCleanupConnectionPoolID (  
                SQLHENV    EnvironmentHandle  
                SQLPOOLID  PoolID );  

Arguments

EnvironmentHandle
[Input] Pengelolaan lingkungan dari kolam renang.

PoolID
[Input] Pool yang terkait dengan ID pool yang sudah habis.

Returns

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR, atau SQL_INVALID_HANDLE.

Diagnostics

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

Sebuah aplikasi tidak dapat menerima pesan kesalahan yang dikembalikan oleh driver.

Remarks

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

Driver dapat membersihkan sumber daya yang terkait dengan ID pool.

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.