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 |