FUNKCE SQLCleanupConnectionPoolID

Soulad
Představená verze: ODBC 3.81 Shoda standardů: ODBC

Summary
SQLCleanupConnectionPoolID informuje ovladač, že ID poolu vypršelo časově omezené. ID poolu může vypršet čas, kdykoli všechna připojení v poolu spojeném s tímto ID vypršela. Více informací o vypršení připojení najdete v sekci Pooling in the Microsoft Data Access Components.

Syntax

  
SQLRETURN  SQLCleanupConnectionPoolID (  
                SQLHENV    EnvironmentHandle  
                SQLPOOLID  PoolID );  

Arguments

EnvironmentHandle
[Vstup] Environmentální ovládání bazénu.

PoolID
[Vstup] Pool spojený s ID poolu, který vypršel čas.

Returns

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR nebo SQL_INVALID_HANDLE.

Diagnostika

Správce ovladačů nezpracovává diagnostické informace vrácené ze SQLCleanupConnectionPoolID.

Aplikace nemůže přijmout chybovou zprávu vrácenou ovladačem.

Remarks

SQLCleanupConnectionPoolID lze volat kdykoli, ale správce ovladačů zaručuje, že žádné jiné vlákno současně nevolá SQLGetPoolID a žádné jiné vlákno současně nevolá SQLRateConnection a SQLPoolConnect s tokenem o info spojení přiřazeným k tomuto ID poolu. Proto musí ovladač zajistit, že tato funkce je bezpečná pro vlákna.

Ovladač může vyčistit zdroje spojené s ID poolu.

Aplikace by tuto funkci neměly volat přímo. ODBC ovladač, který podporuje poolování připojení s vědomím ovladačů, musí tuto funkci implementovat.

Zahrňte sqlspi.h pro vývoj ovladačů ODBC.