Função SQLCleanupConnectionPoolID

Conformidade
Versão Introduzida: Conformidade com as Normas ODBC 3.81: ODBC

Summary
SQLCleanupConnectionPoolID informa um driver que um ID de pool foi temporizado. Um ID de pool pode expirar sempre que todas as ligações de um pool associadas a esse ID de pool forem esgotadas. Consulte Pooling nos Componentes de Acesso a Dados da Microsoft para mais informações sobre o tempo limite da ligação.

Syntax

  
SQLRETURN  SQLCleanupConnectionPoolID (  
                SQLHENV    EnvironmentHandle  
                SQLPOOLID  PoolID );

Arguments

EnvironmentHandle
[Entrada] O controlo ambiental da piscina.

PoolID
[Entrada] O pool associado ao ID do pool que estava com tempo de expiração.

Devoluções

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR ou SQL_INVALID_HANDLE.

Diagnósticos

O Gestor de Drivers não processa as informações de diagnóstico devolvidas pelo SQLCleanupConnectionPoolID.

Uma aplicação não pode receber a mensagem de erro devolvida pelo driver.

Observações

O SQLCleanupConnectionPoolID pode ser chamado a qualquer momento, mas o Gestor de Drivers garante que nenhum outro thread está a chamar simultaneamente SQLGetPoolID e nenhum outro thread está a chamar simultaneamente SQLRateConnection e SQLPoolConnect com um token de informação de ligação atribuído a esse ID de pool. Portanto, o driver deve garantir que esta função é segura para threads.

Um condutor pode limpar os recursos associados ao ID do pool.

As aplicações não devem chamar esta função diretamente. Um driver ODBC que suporta pooling de conexões consciente do driver deve implementar esta função.

Incluir sqlspi.h para desenvolvimento de drivers ODBC.

Conteúdo relacionado

  • Last updated on