Compartilhar via


CDatabase::OnSetOptions

A estrutura chama essa função de membro diretamente ao executar uma instrução SQL com a função de membro de ExecuteSQL .

virtual void OnSetOptions( 
   HSTMT hstmt  
);

Parâmetros

  • hstmt
    O identificador de declaração ODBC para que as opções são definidas.

Comentários

CRecordset::OnSetOptions também chama essa função de membro.

OnSetOptions define o valor de tempo limite de logon. Se houve um chamadas anteriores a SetQueryTimeout e a função de membro, OnSetOptions reflete os valores atuais; caso contrário, defina valores padrão.

Dica

Antes de MFC 4,2, OnSetOptions também define o modo de processamento a snychronous ou a assíncrona.Iniciando com o MFC 4,2, todas as operações são síncronos.Para executar uma operação assíncrona, você deve fazer uma chamada direto à função da API SQLSetPosODBC.

Você não precisa substituir OnSetOptions para alterar o valor de tempo limite. Em vez de isso, para personalizar o valor de tempo limite de consulta, chamada SetQueryTimeout antes de criar um conjunto de registros; OnSetOptions usará o novo valor. Os valores definidos se aplicam às operações subsequentes em todos os conjuntos de registros ou chamadas diretas SQL.

Substitua OnSetOptions se você desejar definir opções adicionais. Sua substituição deve chamar a classe base OnSetOptions ou antes ou após você chama a função da API SQLSetStmtOptionODBC. Siga o método ilustrado na implementação padrão da estrutura de OnSetOptions.

Requisitos

Cabeçalho: afxdb.h

Consulte também

Referência

Classe incorporadas

Gráfico da hierarquia

CDatabase::

CDatabase::SetQueryTimeout

CRecordset::OnSetOptions