Поделиться через

структура 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

Идентификатор текущего узла. Дополнительные сведения см. в разделе CLFS_NODE_ID.

hLog

Дескриптор проверяемого журнала, полученный из CreateLogFile с разрешениями на сканирование контейнеров журналов.

cIndex

Индекс текущего контейнера.

cContainers

Количество системных CLFS_CONTAINER_INFORMATION структур в массиве, на который указывает pinfoContainer.

То есть этот элемент — это количество контейнеров для проверки при каждом вызове проверки. Вызывающий объект знает, что проверка завершена, если количество возвращаемых контейнеров меньше этого значения.

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 структур, заполняемых ScanLogContainers после каждого успешного вызова.

Комментарии

Эта структура выделяется клиентом, инициализируется с помощью CreateLogContainerScanContext, а затем передается в ScanLogContainers в повторяющихся вызовах.

Требования

Требование Значение
Минимальная версия клиента сборка Windows 10 20348
Минимальная версия сервера сборка Windows 10 20348
Верхняя часть clfs.h

См. также раздел

CLFS_CONTAINER_INFORMATION

CLFS_NODE_ID

ScanLogContainers