ClfsCloseAndResetLogFile 함수(wdm.h)

  • 아티클

ClfsCloseAndResetLogFile 루틴은 지정된 로그 파일 개체에 대한 모든 참조를 해제하고 연결된 스트림을 다시 설정하도록 표시합니다.

구문

CLFSUSER_API NTSTATUS ClfsCloseAndResetLogFile(
  [in] PLOG_FILE_OBJECT plfoLog
);

매개 변수

[in] plfoLog

참조가 해제될 LOG_FILE_OBJECT 구조체에 대한 포인터입니다. 호출자는 이전에 ClfsCreateLogFile을 호출하여 이 포인터를 얻었습니다.

반환 값

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

설명

ClfsCloseAndResetLogFile 은 CLFS에서 획득한 모든 참조를 지정된 로그 파일 개체로 해제합니다. 일반적으로 클라이언트는 로그 파일 개체에 대한 추가 참조를 획득하지 않습니다. 그러나 클라이언트가 추가 참조를 얻은 경우 이를 해제하는 것은 클라이언트의 책임입니다.

ClfsCloseAndResetLogFile 을 사용하면 지정된 로그 파일 개체의 참조 수가 0으로 떨어지며, 이때 로그 파일 개체가 닫힙니다(즉, 메모리가 할당 취소됨). 그러나 동일한 스트림을 나타내는 다른 로그 파일 개체가 있을 수 있으므로 로그 파일 개체로 표시되는 스트림이 다시 설정되지 않을 수 있습니다. 스트림을 나타내는 모든 로그 파일 개체가 닫힌 후 스트림이 다시 설정됩니다(예: ClfsCloseLogFileObject 호출).

다시 설정 스트림은 레코드가 기록된 적이 없는 새로 만든 스트림과 같습니다.

이 루틴에서 반환되면 plfoLog 가 잘못되었습니다.

지정된 스트림에 대해 최대 124번 ClfsCloseAndResetLogFile 을 호출할 수 있습니다.

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

요구 사항

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

추가 정보

ClfsCloseLogFileObject

ClfsDeleteLogByPointer

ClfsDeleteLogFile