ClfsDeleteLogFile 함수(wdm.h)

ClfsDeleteLogFile 루틴은 삭제할 CLFS 스트림을 표시합니다.

구문

CLFSUSER_API NTSTATUS ClfsDeleteLogFile(
  [in]           PUNICODE_STRING puszLogFileName,
                 PVOID           pvReserved,
  [in]           ULONG           fLogOptionFlag,
  [in, optional] PVOID           pvContext,
  [in]           ULONG           cbContext
);

매개 변수

[in] puszLogFileName

삭제할 CLFS 스트림의 이름을 제공하는 UNICODE_STRING 구조체에 대한 포인터입니다.

삭제할 스트림이 전용 로그의 유일한 스트림인 경우 이름에는 log:physical log name 양식이 있습니다. 여기서 실제 로그 이름은 기본 파일 시스템의 실제 로그의 경로 이름입니다.

삭제할 스트림이 멀티플렉싱된 로그의 스트림 중 하나인 경우 이름에는 log:physical log name::stream 이름이 있습니다. 여기서 실제 로그 이름은 기본 파일 시스템의 실제 로그 경로 이름이고 스트림 이름은 삭제할 스트림의 고유한 이름입니다.

pvReserved

예약되어 있습니다.

[in] fLogOptionFlag

CLFS와 로그를 삭제하는 구성 요소 간의 관계를 나타내는 값입니다. 가능한 값 목록은 ClfsCreateLogFile 루틴의 fLogOptionFlag 매개 변수에 대한 설명을 참조하세요.

[in, optional] pvContext

컨텍스트에 대한 포인터입니다. 컨텍스트가 해석되는 방식은 fLogOptionFlag에 전달된 값에 따라 달라집니다.

[in] cbContext

pvContext가 가리키는 컨텍스트의 크기(바이트)입니다. pvContext가 NULL이 아니면 이 매개 변수가 0보다 커야 합니다.

반환 값

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

설명

CLFS(Common Log File System)는 LOG_FILE_OBJECT 구조를 사용하여 로그를 나타냅니다. ClfsCreateLogFile 함수는 LOG_FILE_OBJECT 대한 포인터를 반환합니다. 그러면 클라이언트가 다른 CLFS 함수에 전달됩니다.

CLFS 클라이언트는 LOG_FILE_OBJECT 구조체의 멤버에 직접 액세스하지 않습니다. 멤버에 대한 자세한 내용은 FILE_OBJECT 참조하세요.

ClfsDeleteLogFile 은 삭제할 스트림을 표시하지만 현재 열려 있는 로그 파일 개체는 닫지 않습니다. 로그 파일 개체를 닫려면 ClfsCloseLogFileObject를 호출합니다. 삭제로 표시된 스트림은 스트림과 연결된 모든 로그 파일 개체가 닫힌 후에 삭제됩니다.

삭제로 표시된 CLFS 스트림은 스트림 열기에 대한 후속 요청을 거부합니다.

실제 CLFS 로그의 이름에는 .blf 확장이 포함되지 않습니다.

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

요구 사항

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

추가 정보

ClfsCloseAndResetLogFile

ClfsCloseLogFileObject

ClfsCreateLogFile

ClfsDeleteLogByPointer