次の方法で共有


CDatabase::OnSetOptions

フレームワークは、直接 ExecuteSQL のメンバー関数の SQL ステートメントを実行すると、このメンバー関数を呼び出します。

virtual void OnSetOptions(
   HSTMT hstmt 
);

パラメーター

  • hstmt
    オプションが設定されている ODBC ステートメントのハンドル。

解説

CRecordset::OnSetOptions は、このメンバー関数を呼び出します。

OnSetOptions は、ログイン タイムアウト値を設定します。前の呼び出しが SetQueryTimeout にあり、メンバー関数 OnSetOptions すると、は現在値を反映します; それ以外の場合は、既定値を設定します。

[!メモ]

MFC 4.2 前に、OnSetOptions は、snychronous または非同期の操作のモードを設定します。MFC 4.2 以降では、すべての操作は同期的です。非同期操作を実行するには、ODBC API 関数 SQLSetPosに直接呼び出しを行う必要があります。

タイムアウト値を変更するに OnSetOptions をオーバーライドする必要はありません。代わりに、クエリ タイムアウト値を、呼び出し SetQueryTimeout レコードセットを作成する前にカスタマイズする; OnSetOptions は新しい値が使用されます。設定される値は、すべてのレコードセットまたは SQL を直接呼び出すの後続に適用されます。

追加のオプションを指定する場合は、OnSetOptions をオーバーライドします。は、オーバーライド関数は SQLSetStmtOptionな ODBC API 関数を呼び出す前または後に基本クラスを OnSetOptions いずれかを呼び出す必要があります。OnSetOptionsのフレームワークの既定の実装で説明したメソッドに従います。

必要条件

Header: afxdb.h

参照

関連項目

CDatabase クラス

階層図

CDatabase::ExecuteSQL

CDatabase::SetQueryTimeout

CRecordset::OnSetOptions