CLS_SCAN_CONTEXT 结构 (clfs.h)

包含有关 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

当前节点的 ID。 有关详细信息，请参阅 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 ，则无法使用。

pinfoContainer

指向客户端分配的 CLFS_CONTAINER_INFORMATION 结构的指针，该数组将在每次成功调用后由 ScanLogContainer 填充 。

注解

此结构由客户端分配，使用 CreateLogContainerScanContext 进行初始化，然后在重复调用中传递给 ScanLogContainers 。

要求

要求	值
最低受支持的客户端	Windows 10内部版本 20348
最低受支持的服务器	Windows 10内部版本 20348
标头	clfs.h

另请参阅

CLFS_CONTAINER_INFORMATION

CLFS_NODE_ID

ScanLogContainers