GetLogFileInformation 関数 (clfsw32.h)

指定したログとその現在の状態に関するメタデータを含むバッファーを返します。これは、 CLFS_INFORMATION 構造体によって定義されます。

取得されたデータは、呼び出しが行われた時点のログの状態のみを反映します。 通常、クライアントは、次にレコードを追加するか、再起動領域を書き込むまで、この構造体のフィールドをキャッシュして使用し続けることができます。 その時点で、一部の情報は古くなります。

構文

CLFSUSER_API BOOL GetLogFileInformation(
  [in]      HANDLE            hLog,
  [in, out] PCLFS_INFORMATION pinfoBuffer,
  [in, out] PULONG            cbBuffer
);

パラメーター

[in] hLog

CreateLogFile の正常な呼び出しから取得された開いているログへのハンドル。

ログ ハンドルは、専用または多重化されたログを参照できます。

[in, out] pinfoBuffer

ログ メタデータを受け取るユーザー割り当て CLFS_INFORMATION 構造体へのポインター。

[in, out] cbBuffer

入力時に pinfoBuffer が指すメタデータ バッファーのサイズをバイト単位で指定する変数へのポインター。

出力時に、 pinfoBuffer に実際にコピーされるバイト数を指定します。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

次の一覧は、考えられるエラー コードを示しています。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 R2 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	clfsw32.h
Library	Clfsw32.lib
[DLL]	Clfsw32.dll

こちらもご覧ください

CLFS_INFORMATION

一般的なログ ファイル システム関数

CreateLogFile

次の LSN の取得