estrutura CLS_SCAN_CONTEXT (clfs.h)

Artigo
02/23/2024

Contém informações sobre os contêineres que estão sendo verificados por ScanLogContainers, o tipo de verificação que está sendo executado e um cursor para rastrear quais contêineres foram verificados.

Sintaxe

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;

Membros

cidNode

A ID do nó atual. Para obter mais informações, consulte CLFS_NODE_ID.

hLog

Um identificador para o log que está sendo verificado obtido do CreateLogFile com permissões para verificar os contêineres de log.

cIndex

O índice do contêiner atual.

cContainers

O número de estruturas de CLFS_CONTAINER_INFORMATION alocadas pelo sistema em uma matriz que é apontada por pinfoContainer.

Ou seja, esse membro é o número de contêineres a serem digitalizados com cada chamada de verificação. O chamador sabe que a verificação está concluída quando o número de contêineres retornados é menor que esse valor.

cContainersReturned

O número de contêineres retornados após uma chamada para ScanLogContainers.

eScanMode

O modo no qual os contêineres são verificados.

Os contêineres podem ser verificados em um dos modos a seguir.

Valor	Significado
CLFS_SCAN_INIT	Inicializa o contexto de verificação, mas não aloca o armazenamento associado. A inicialização é destrutiva, pois todos os dados armazenados no contexto de verificação atual são perdidos.
CLFS_SCAN_CLOSE	Não inicializa o contexto de verificação e desaloca o armazenamento do sistema associado a um contexto de verificação.
CLFS_SCAN_FORWARD	Faz com que a próxima chamada para ScanLogContainers prossiga em direção à frente. Não será possível usar se CLFS_SCAN_BACKWARD for especificado.
CLFS_SCAN_BACKWARD	Faz com que a próxima chamada para ScanLogContainers prossiga na direção anterior. Não será possível usar se CLFS_SCAN_FORWARD for especificado.

pinfoContainer

Um ponteiro para uma matriz alocada pelo cliente de CLFS_CONTAINER_INFORMATION estruturas a serem preenchidas por ScanLogContainers após cada chamada bem-sucedida.