ClfsRemoveLogContainer 함수(wdm.h)

아티클
02/27/2024

ClfsRemoveLogContainer 루틴은 CLFS 로그에서 컨테이너를 제거합니다.

구문

CLFSUSER_API NTSTATUS ClfsRemoveLogContainer(
  [in] PLOG_FILE_OBJECT plfoLog,
  [in] PUNICODE_STRING  puszContainerPath,
  [in] BOOLEAN          fForce
);

매개 변수

[in] plfoLog

컨테이너가 제거될 CLFS 로그를 나타내는 LOG_FILE_OBJECT 구조체에 대한 포인터입니다. 호출자는 이전에 ClfsCreateLogFile을 호출하여 이 포인터를 얻었습니다.

[in] puszContainerPath

제거할 컨테이너의 경로 이름을 제공하는 UNICODE_STRING 구조체에 대한 포인터입니다. 경로 이름은 ClfsAddLogContainer 또는 ClfsAddLogContainerSet 에 대한 이전 호출에서 만들어졌습니다. 경로는 절대 경로이거나 plfoLog로 표시되는 CLFS 로그에 대한 기본 로그 파일의 위치를 기준으로 할 수 있습니다. 기본 로그 파일을 기준으로 하는 경로는 문자열 리터럴(L"%BLF%\")인 CLFS_CONTAINER_RELATIVE_PREFIX 시작해야 합니다. "." 및 ".." 디렉터리를 상대 경로에서 사용할 수 없습니다.

[in] fForce

컨테이너 제거가 강제 적용(TRUE) 또는 지연(FALSE)인지 여부를 지정하는 부울 값입니다.

반환 값

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

설명

제거할 컨테이너가 활성 로그의 일부가 아닌 경우에만 강제 컨테이너 제거(fForce = TRUE)가 성공합니다.

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

요구 사항

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