GetNextLogArchiveExtent 函式 (clfsw32.h)

擷取記錄封存內容中的下一組封存範圍。 記錄封存內容描述一組連續的檔案範圍，跨越 PrepareLogArchive 擷取所擷取之使用中記錄檔的快照集。 GetNextLogArchiveExtent 會在已排序的記錄封存描述元集中維護數據指標，讓後續呼叫允許應用程式逐一查看整個集合。

語法

CLFSUSER_API BOOL GetNextLogArchiveExtent(
  [in]      CLFS_LOG_ARCHIVE_CONTEXT   pvArchiveContext,
  [in, out] CLFS_ARCHIVE_DESCRIPTOR [] rgadExtent,
  [in]      ULONG                      cDescriptors,
  [out]     PULONG                     pcDescriptorsReturned
);

參數

[in] pvArchiveContext

由 PrepareLogArchive 呼叫取得之封存內容的指標。

內容會維護數據指標狀態，允許在封存中的一組檔案範圍中進行反覆執行。 封存客戶端負責使用 TerminateLogArchive 函式解除分配內容。

[in, out] rgadExtent

此函式要填入之 CLFS_ARCHIVE_DESCRIPTOR 結構的用戶端配置陣列。

[in] cDescriptors

rgadExtent 陣列中的元素數目。

這個值是這個函式可擷取的封存描述元數目上限。

[out] pcDescriptorsReturned

此函式所填入 之 rgadExtent 陣列中的描述項數目。

如果此值小於 cDescriptors，則會耗盡描述元集合，而且封存用戶端可以透過已排序的描述元集終止反覆專案。 此函式的進一步呼叫失敗，ERROR_NO_MORE_ENTRIES。

傳回值

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

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

規格需求

另請參閱

CLFS_ARCHIVE_DESCRIPTOR

一般記錄檔系統函式