Compartilhar via


CDatabase::SetQueryTimeout

Chamar essa função de membro para substituir o padrão número de segundos para permitir antes das operações subsequentes no tempo limite conectado da fonte de dados.

void SetQueryTimeout( 
   DWORD dwSeconds  
);

Parâmetros

  • dwSeconds
    O número de segundos para permitir antes do tempo limite de uma tentativa de consulta.

Comentários

Uma operação pode tempo limite devido a problemas de acesso à rede, o tempo de processamento excessivos de consulta, e assim por diante. Antes de chamar SetQueryTimeout abra o conjunto de registros ou antes de chamar AddNewdo conjunto de registros, Atualizar ou funções de membro de Excluir se você desejar alterar o valor de tempo limite de consulta. A configuração afeta todo o Abrirsubseqüente, AddNew, Atualizar, e chamadas de Excluir a todos os conjuntos de registros associados com esse CDatabase objeto. Alterando o valor de tempo limite de consulta para um recordset após abrir não muda o valor para o conjunto de registros. Por exemplo, as operações subsequentes de Mover não usam o novo valor.

O valor padrão para o tempo limite de consulta é 15 segundos. Nem todas as fontes de dados oferecem suporte à capacidade de definir um valor de tempo limite de consulta. Se você definir um valor de tempo limite de consulta de 0, nenhum tempo limite ocorre; a comunicação com a fonte de dados pode parar de responder. Esse comportamento pode ser útil durante o desenvolvimento. Se a fonte de dados não suporta o tempo limite, você obtém a saída de rastreamento mas não uma exceção.

Requisitos

Cabeçalho: afxdb.h

Consulte também

Referência

Classe incorporadas

Gráfico da hierarquia

CDatabase::SetLoginTimeout