Freigeben über


CDatabase::OnSetOptions

Das Framework ruft diese Memberfunktion auf, wenn eine SQL-Anweisung direkt mit der ExecuteSQL-Memberfunktion ausführt.

virtual void OnSetOptions(
   HSTMT hstmt 
);

Parameter

  • hstmt
    Das ODBC-Anweisungshandle, für das Optionen festgelegt werden.

Hinweise

CRecordset::OnSetOptions ruft auch diese Memberfunktion auf.

OnSetOptions legt den Anmelden Timeoutwert fest.Wenn es vorherige Aufrufe SetQueryTimeout und der Memberfunktion geändert hat, spiegelt OnSetOptions die aktuellen Werte; andernfalls legt es Standardwerte.

HinweisHinweis

Vor MFC 4.2 legt OnSetOptions auch den Verarbeitungsaufwand Modus entweder zu snychronous oder zu erreichen fest.Ab MFC 4.2, sind alle Vorgänge synchron.So fügen Sie einen asynchronen Vorgang auszuführen, müssen Sie einen direkten Aufruf der ODBC-API-Funktion SQLSetPos.

Sie müssen nicht, um OnSetOptions zu überschreiben, um den Timeoutwert zu ändern.Stattdessen den Abfragentimeoutwert anpassen, Aufruf SetQueryTimeout, bevor ein Recordset erstellt wird; OnSetOptions verwendet den neuen Wert.Die festgelegten Werte gelten für folgende Vorgänge auf allen Recordsets oder direkten SQL-Aufrufen zu.

Überschreiben Sie OnSetOptions, wenn Sie zusätzliche Optionen festlegen möchten.Die Überschreibung sollte die Basisklasse OnSetOptions entweder aufrufen, bevor oder nachdem Sie die ODBC-API-Funktion SQLSetStmtOption aufrufen.Folgen Sie der Methode, die in der Standardimplementierung des Frameworks von OnSetOptions veranschaulicht wird.

Anforderungen

Header: afxdb.h

Siehe auch

Referenz

CDatabase-Klasse

Hierarchien-Diagramm

CDatabase::ExecuteSQL

CDatabase::SetQueryTimeout

CRecordset::OnSetOptions