ClfsSetLogFileInformation 함수(wdm.h)

아티클
08/08/2023

ClfsSetLogFileInformation 루틴은 지정된 스트림 및 해당 기본 물리적 로그에 대한 메타데이터 및 상태 정보를 설정합니다.

구문

CLFSUSER_API NTSTATUS ClfsSetLogFileInformation(
  [in] PLOG_FILE_OBJECT           plfoLog,
  [in] CLFS_LOG_INFORMATION_CLASS eInformationClass,
  [in] PVOID                      pinfoBuffer,
  [in] ULONG                      cbBuffer
);

매개 변수

[in] plfoLog

CLFS 스트림을 나타내는 LOG_FILE_OBJECT 구조체에 대한 포인터입니다. 호출자는 이전에 ClfsCreateLogFile을 호출하여 이 포인터를 얻었습니다.

[in] eInformationClass

설정되는 정보의 클래스를 지정하는 CLFS_LOG_INFORMATION_CLASS 값입니다.

[in] pinfoBuffer

로그 정보를 제공하는 버퍼에 대한 포인터입니다. 이 버퍼의 구조는 eInformationClass에 지정된 정보 클래스에 따라 달라집니다. 다음 표에서는 정보 클래스와 버퍼 형식 간의 관계를 보여 줍니다.

eInformationClass의 값	pinfoBuffer가 가리키는 버퍼 유형
ClfsLogBasicInformation	CLFS_INFORMATION
ClfsLogBasicInformationPhysical	CLFS_INFORMATION
ClfsLogNameInformation	CLFS_LOG_NAME_INFORMATION
ClfsLogPhysicalNameInformation	CLFS_LOG_NAME_INFORMATION
ClfsLogStreamIdentifierInformation	CLFS_STREAM_ID_INFORMATION

[in] cbBuffer

pinfoBuffer가 가리키는 버퍼의 크기(바이트)입니다.

반환 값

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

설명

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

요구 사항

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