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) 。 在後續的呼叫中，指定 在 azureBytesRead中傳回的值。

[in] cbBytesToRead

中繼資料快照集的位元組數目應該複製到 pbReadBuffer。

此參數不能為 0 (0) 。

[in, out] pbReadBuffer

複製中繼資料快照集之緩衝區的指標。

[out] pcbBytesRead

變數的指標，接收復制到 pbReadBuffer的位元組數目。

位元組數目一律介於零 (0) 和 cbBytesToRead之間。

傳回值

如果函式成功，則傳回非零的值。

如果函式失敗，傳回值為零， (0) 。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。 下列清單會識別可能的錯誤碼：

規格需求

另請參閱

一般記錄檔系統函式

PrepareLogArchive

TerminateLogArchive