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 개념 및 용어에 대한 설명은 공통 로그 파일 시스템을 참조하세요.

요구 사항

추가 정보

ClfsCloseLogFileObject

ClfsDeleteLogByPointer

ClfsDeleteLogFile