ClfsScanLogContainers 함수(wdm.h)

ClfsScanLogContainers 루틴은 특정 CLFS 로그에 속하는 컨테이너 시퀀스에 대한 설명 정보를 검색합니다.

구문

CLFSUSER_API NTSTATUS ClfsScanLogContainers(
  [in, out] PCLFS_SCAN_CONTEXT pcxScan,
  [in]      CLFS_SCAN_MODE     eScanMode
);

매개 변수

[in, out] pcxScan

CLFS_SCAN_CONTEXT 구조체에 대한 포인터입니다. 호출자는 이전에 구조를 할당하고 ClfsCreateScanContext를 호출하여 초기화했습니다. 특히 pInfoContainer 멤버는 CLFS_CONTAINER_INFORMATION 구조체의 배열을 가리키도록 초기화되었으며 cContainers 멤버는 배열의 요소 수로 초기화되었습니다. 반환 시 배열의 구조체는 시퀀스의 컨테이너에 대한 설명 정보를 받습니다.

[in] eScanMode

검사 방향과 검사 컨텍스트를 닫아야 하는지 여부를 지정하는 플래그 집합입니다. 이 루틴의 호출자는 다음 플래그를 사용할 수 있습니다.

값	의미
CLFS_SCAN_FORWARD	정방향으로 스캔합니다. 예를 들어 컨테이너 5가 가장 최근에 검사된 컨테이너이고 pxcScan->cContainers 가 2인 경우 이 루틴은 컨테이너 6 및 7에 대한 설명자를 반환합니다.
CLFS_SCAN_BACKWARD	뒤로 방향으로 스캔합니다. 예를 들어 컨테이너 5가 가장 최근에 검사된 컨테이너이고 pxcScan->cContainers 가 2인 경우 이 루틴은 컨테이너 4 및 3에 대한 설명자를 반환합니다.
CLFS_SCAN_CLOSE	pcxScan에서 가리키는 검사 컨텍스트와 연결된 모든 리소스를 해제합니다.

 

CLFS_SCAN_CLOSE 플래그가 설정되면 CLFS_SCAN_FORWARD 플래그와 CLFS_SCAN_BACKWARD 플래그가 모두 명확해야 합니다.

CLFS_SCAN_CLOSE 플래그가 명확하면 방향 플래그(CLFS_SCAN_FORWARD 또는 CLFS_SCAN_BACKWARD) 중 하나만 설정해야 합니다.

반환 값

ClfsScanLogContainers 는 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 Ntstatus.h에 정의된 오류 코드 중 하나를 반환합니다.

설명

CLFS는 CLFS_SCAN_CONTEXT 구조를 사용하여 컨테이너 검색이 시작되는 위치( cIndex 멤버)와 ClfsScanLogContainers에 대한 각 호출에서 검사되는 컨테이너 수를 추적합니다. cContainers 멤버의 값 N은 ClfsScanLogContainers가 호출될 때마다 다음 N 컨테이너가 검사되도록 지정합니다.

CLFS_SCAN_CONTEXT 구조체의 cContainersReturned 멤버는 ClfsScanLogContainers에 대한 단일 호출에서 실제로 검사된 컨테이너 수를 받습니다.

ClfsScanLogContainers가 STATUS_NO_MORE_ENTRIES 반환하면 검사할 컨테이너가 더 이상 없습니다.

pcxScan에서 가리키는 검사 컨텍스트 사용을 완료한 경우 검색 컨텍스트와 연결된 모든 리소스를 해제하려면 eScanMode가 CLFS_SCAN_CLOSE 동일한 ClfsScanLogContainers를 호출해야 합니다.

CLFS 개념 및 용어에 대한 설명은 공통 로그 파일 시스템을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Server 2003 R2, Windows Vista 및 이후 버전의 Windows에서 사용할 수 있습니다.
대상 플랫폼	데스크톱
헤더	wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함)
라이브러리	Clfs.lib
DLL	Clfs.sys
IRQL	<= APC_LEVEL

추가 정보

CLFS_CONTAINER_INFORMATION

CLFS_SCAN_CONTEXT

ClfsCreateScanContext