clfs.h) CLS_SCAN_CONTEXT (結構

發行項
02/23/2024

包含 ScanLogContainers 正在掃描之容器的相關信息、正在執行的掃描種類，以及追蹤已掃描哪些容器的數據指標。

語法

typedef struct _CLS_SCAN_CONTEXT {
  CLFS_NODE_ID               cidNode;
  HANDLE                     hLog;
  ULONG                      cIndex;
  ULONG                      cContainers;
  ULONG                      cContainersReturned;
  CLFS_SCAN_MODE             eScanMode;
  PCLS_CONTAINER_INFORMATION pinfoContainer;
} CLS_SCAN_CONTEXT, *PCLS_SCAN_CONTEXT, PPCLS_SCAN_CONTEXT;

成員

cidNode

目前節點的標識碼。如需詳細資訊，請參閱 CLFS_NODE_ID。

hLog

正在掃描之記錄的句柄，可從 CreateLogFile 取得，並具有掃描記錄容器的許可權。

cIndex

目前容器的索引。

cContainers

pinfoContainer 所指向數位系統配置的CLFS_CONTAINER_INFORMATION結構數目。

也就是說，此成員是每個掃描呼叫要掃描的容器數目。呼叫端知道當傳回的容器數目小於此值時，掃描已完成。

cContainersReturned

呼叫 ScanLogContainers 之後傳回的容器數目。

eScanMode

掃描容器的模式。

您可以在下列其中一種模式中掃描容器。

值	意義
CLFS_SCAN_INIT	初始化掃描內容，但不會配置相關聯的記憶體。初始化是破壞性的，因為儲存在目前掃描內容中的所有數據都會遺失。
CLFS_SCAN_CLOSE	取消初始化掃描內容，並解除分配與掃描內容相關聯的系統記憶體。
CLFS_SCAN_FORWARD	導致下一次呼叫 ScanLogContainers 繼續往前方向。如果指定 CLFS_SCAN_BACKWARD ，則無法使用。
CLFS_SCAN_BACKWARD	導致下一次呼叫 ScanLogContainers 以向後方向繼續。如果指定 CLFS_SCAN_FORWARD，則無法使用。