ILog::Force メソッド (txlogpub.h)
少なくとも指定された LSN を介して、ログの内容を強制的にディスクに移動します。
構文
HRESULT Force(
[in] LSN lsnMinToForce
);
パラメーター
[in] lsnMinToForce
少なくとも、 lsnMinToForce 以下の LSN を持つディスクにまだ書き込まれていないすべてのレコードは、今すぐディスクに書き込む必要があります。 ただし、実装では、厳密に必要なレコードよりも多くのレコードを書き込む場合があります。 たとえば、実装では、 lsnMinToForce の値に関係なく、すべてのレコードを強制的にディスクに送信できます。 0 を lsnMinToForce として渡すと、ログ全体が強制的にディスクに強制されることを示します。
戻り値
このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。
解説
また、個々のレコードを追加した後、ログを強制的にディスクに追加することもできます。 「ILog::AppendRecord」を参照してください。
呼び出し元へのメモ
エラーの戻り値は、前回正常に強制された後にログに追加されたレコードが、ディスク上に存在することが保証されないことを示します。 ILog インターフェイスには、ディスクに正常に書き込まれたレコードを特定するメソッドは用意されていません。 ディスクに正常に書き込まれたレコードを知る必要がある場合は、各レコードのログを強制的に作成する必要があります。 「ILog::AppendRecord」を参照してください。実装者へのメモ
このメソッドから戻る前に、( FlushFileBuffers 関数を使用して) ファイル バッファーをフラッシュすることをお勧めします。要件
サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
対象プラットフォーム | Windows |
ヘッダー | txlogpub.h |