ScanLogContainers 함수(clfsw32.h)

아티클
02/28/2024

로그 컨테이너를 열거합니다. 이 함수를 반복적으로 호출하여 모든 로그 컨테이너를 반복합니다.

구문

CLFSUSER_API BOOL ScanLogContainers(
  [in, out]           PCLFS_SCAN_CONTEXT pcxScan,
  [in]                CLFS_SCAN_MODE     eScanMode,
  [in, out, optional] LPVOID             pReserved
);

매개 변수

[in, out] pcxScan

CreateLogContainerScanContext 함수가 초기화하는 클라이언트 할당 CLFS_SCAN_CONTEXT 구조체에 대한 포인터입니다.

[in] eScanMode

검사할 컨테이너의 모드입니다.

컨테이너는 다음 CLFS_SCAN_MODE 모드에서 검사할 수 있습니다.

값	의미
CLFS_SCAN_INIT	검사 컨텍스트를 다시 초기화하지만 연결된 스토리지는 할당하지 않습니다. 현재 검사 컨텍스트에 저장된 모든 데이터가 손실되므로 초기화는 파괴적입니다.
CLFS_SCAN_CLOSE	검사 컨텍스트를 초기화하지 않고 검사 컨텍스트와 연결된 시스템 스토리지의 할당을 취소합니다.
CLFS_SCAN_FORWARD	ScanLogContainers에 대한 다음 호출이 앞으로 진행되도록 합니다. CLFS_SCAN_BACKWARD 지정한 경우에는 사용할 수 없습니다.
CLFS_SCAN_BACKWARD	ScanLogContainers에 대한 다음 호출이 뒤로 진행되도록 합니다. CLFS_SCAN_FORWARD 지정한 경우에는 사용할 수 없습니다.

[in, out, optional] pReserved

예약되어 있습니다. pReserved를 NULL로 설정합니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

다음 목록에서는 가능한 오류 코드를 식별합니다.

설명

로그 컨테이너의 ID는 pcxScan-pinfoContainer-LogicalContainerId>>에 반환됩니다.

참고 CLFS(Common Log File System) 검사 컨텍스트는 스레드로부터 안전하지 않습니다. 한 번에 둘 이상의 스레드에서 사용하거나 한 번에 둘 이상의 비동기 검사에 전달해서는 안 됩니다.

예제

이 함수를 사용하는 예제는 로그 컨테이너 열거를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 R2 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	clfsw32.h
라이브러리	Clfsw32.lib
DLL	Clfsw32.dll