Partilhar 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 de CDatabase

Gráfico de hierarquia

CDatabase::SetLoginTimeout