Partilhar via


Função SQLCleanupConnectionPoolID

Conformidade
Versão introduzida: ODBC 3.81 Standards Compliance: ODBC

Resumo
SQLCleanupConnectionPoolID informa a um driver que uma ID do pool atingiu o tempo limite. Uma ID do pool pode ter tempo limite sempre que todas as conexões em um pool associadas a essa ID do pool tiverem atingido o tempo limite. Consulte Pooling nos Componentes do Microsoft Data Access para obter mais informações sobre o tempo limite da conexão.

Sintaxe

  
SQLRETURN  SQLCleanupConnectionPoolID (  
                SQLHENV    EnvironmentHandle  
                SQLPOOLID  PoolID );  

Argumentos

EnvironmentHandle
[Entrada] O identificador de ambiente do pool.

PoolID
[Entrada] O pool associado à ID do pool que atingiu o tempo limite.

Retornos

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR ou SQL_INVALID_HANDLE.

Diagnósticos

O Gerenciador de Driver não processará as informações de diagnóstico retornadas de SQLCleanupConnectionPoolID.

Um aplicativo não pode receber a mensagem de erro retornada pelo driver.

Comentários

SQLCleanupConnectionPoolID pode ser chamado a qualquer momento, mas o Gerenciador de Driver garante que nenhum outro thread esteja chamando simultaneamente SQLGetPoolID e nenhum outro thread esteja chamando simultaneamente SQLRateConnection e SQLPoolConnect com um token de informações de conexão atribuído com essa ID do pool. Portanto, o driver deve garantir que essa função seja thread-safe.

Um driver pode limpar os recursos associados à ID do pool.

Os aplicativos não devem chamar essa função diretamente. Um driver ODBC que dá suporte ao pool de conexões com reconhecimento de driver deve implementar essa função.

Inclua sqlspi.h para desenvolvimento de driver ODBC.

Consulte Também

Desenvolver um driver ODBC
Pool de conexões com reconhecimento de driver
Desenvolvimento um reconhecimento de pool de conexão em um driver ODBC