다음을 통해 공유


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 구조체에 대한 포인터입니다.

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

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

pvReserved

예약.

[in] fLogOptionFlag

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

[in, optional] pvContext

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

[in] cbContext

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

반환 값

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

발언

CLFS(공용 로그 파일 시스템)는 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