ReadLogArchiveMetadata 関数 (clfsw32.h)
メタデータのアーカイブ ビューの範囲を指定したバッファーにコピーします。
構文
CLFSUSER_API BOOL ReadLogArchiveMetadata(
[in] CLFS_LOG_ARCHIVE_CONTEXT pvArchiveContext,
[in] ULONG cbOffset,
[in] ULONG cbBytesToRead,
[in, out] PBYTE pbReadBuffer,
[out] PULONG pcbBytesRead
);
パラメーター
[in] pvArchiveContext
PrepareLogArchive の呼び出しによって取得されるアーカイブ コンテキストへのポインター。
コンテキストはカーソル状態を維持します。これにより、アーカイブ内の一連のファイル エクステントを反復処理できます。 アーカイブ クライアントは、 TerminateLogArchive 関数を使用してコンテキストの割り当てを解除します。
[in] cbOffset
データのコピーが開始されるメタデータ内のオフセット。
この関数の最初の呼び出しで、ゼロ (0) を指定します。 後続の呼び出しでは、 pcbBytesRead で返される値を指定します。
[in] cbBytesToRead
スナップショットメタデータのバイト数を pbReadBuffer にコピーする必要があります。
このパラメーターを 0 にすることはできません。
[in, out] pbReadBuffer
メタデータ スナップショットがコピーされるバッファーへのポインター。
[out] pcbBytesRead
pbReadBuffer にコピーされるバイト数を受け取る変数へのポインター。
バイト数は、常にゼロ (0) から cbBytesToRead の間です。
戻り値
関数が成功すると、戻り値は 0 以外になります。
関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。 次の一覧は、考えられるエラー コードを示しています。
要件
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003 R2 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | clfsw32.h |
| Library | Clfsw32.lib |
| [DLL] | Clfsw32.dll |