CDatabase::OnSetOptions

Artigo
02/25/2013

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.

Observação
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.