Função SQLCleanupConnectionPoolID

Conformidade
Versão Introduzida: ODBC 3.81 Conformidade com os Padronizados: ODBC

Summary
SQLCleanupConnectionPoolID informa a um driver que um ID de pool foi expirado. Um ID de pool pode expirar sempre que todas as conexões em um pool associadas a esse ID de pool estiverem com tempo expirado. Veja Pooling nos Componentes de Acesso a Dados da Microsoft para mais informações sobre o tempo limite da conexão.

Sintaxe

  
SQLRETURN  SQLCleanupConnectionPoolID (  
                SQLHENV    EnvironmentHandle  
                SQLPOOLID  PoolID );

Argumentos

EnvironmentHandle
[Entrada] O controle ambiental da piscina.

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

Returns

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR ou SQL_INVALID_HANDLE.

Diagnostics

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

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

Remarks

SQLCleanupConnectionPoolID pode ser chamado a qualquer momento, mas o Gerenciador de Drivers garante que nenhuma outra thread está chamando simultaneamente SQLGetPoolID e nenhuma outra thread está chamando simultaneamente SQLRateConnection e SQLPoolConnect com um token de informação de conexão atribuído a esse ID de pool. Portanto, o driver deve garantir que essa função seja segura para threads.

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

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

Incluir sqlspi.h para desenvolvimento de drivers ODBC.

Conteúdo relacionado

  • Last updated on