다음을 통해 공유

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

호출이 성공할 때마다 ScanLogContainers가 채울 CLFS_CONTAINER_INFORMATION 구조체의 클라이언트 할당 배열에 대한 포인터입니다.

설명

이 구조체는 클라이언트에 의해 할당되고 CreateLogContainerScanContext를 사용하여 초기화된 다음 반복 호출에서 ScanLogContainers 에 전달됩니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 10 빌드 20348
지원되는 최소 서버 Windows 10 빌드 20348
머리글 clfs.h

추가 정보

CLFS_CONTAINER_INFORMATION

CLFS_NODE_ID

ScanLogContainers