CDatabase::OnSetOptions

virtual privatevoid OnSetOptions ( HSTMT hstmt );

Parâmetros

hstmt

O identificador de instrução ODBC para os quais opções estão sendo definidas.

Observações

A estrutura chama esta função de membro quando uma instrução SQL com a função de membro ExecuteSQL diretamente em execução. CRecordset::OnSetOptions também chama esta função de membro.

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

&Notanbsp;  Antes MFC 4.2, OnSetOptions também defina o modo de processamento para qualquer snychronous ou assíncrona. Começando com o MFC 4.2, todas as operações são síncronas. Para executar uma operação assíncrona, você deve fazer uma chamada direta para a função de API de ODBC SQLSetPos.

Você não precisará substituir OnSetOptions para alterar o valor de tempo limite. Em vez disso, para personalizar o valor de tempo limite de consulta, chame SetQueryTimeout antes de criar um conjunto de registros; OnSetOptions usará o novo valor. O conjunto de valores se aplicam a operações subseqüentes em todos os conjuntos de registros ou chamadas SQL diretos.

Substituir OnSetOptions se você desejar definir opções adicionais. A substituir deve chamar a classe base OnSetOptions antes ou depois que você chamar a função de API de ODBC :: SQLSetStmtOption. Siga o método ilustrado na implementação a estrutura padrão de OnSetOptions.

Visão geral de CDatabaseMembros de classe | Gráfico de hierarquia

Co&nsulte tambémnbsp;CDatabase:: ExecuteSQL, CDatabase::SetQueryTimeout, CRecordset::OnSetOptions

Index