ClfsMgmtInstallPolicy 함수(wdm.h)

  • 아티클

ClfsMgmtInstallPolicy 루틴은 실제 로그에 CLFS_MGMT_POLICY 구조를 추가합니다.

구문

CLFSUSER_API NTSTATUS ClfsMgmtInstallPolicy(
  [in] PLOG_FILE_OBJECT  LogFile,
  [in] PCLFS_MGMT_POLICY Policy,
  [in] ULONG             PolicyLength
);

매개 변수

[in] LogFile

CLFS_MGMT_POLICY 구조체의 이 instance 적용할 CLFS 로그를 나타내는 LOG_FILE_OBJECT 구조체에 대한 포인터입니다. 정책은 로그 내의 단일 스트림이 지정된 경우에도 로그 내의 모든 스트림에 적용됩니다.

[in] Policy

설치할 정책을 포함하는 CLFS_MGMT_POLICY 구조체에 대한 포인터입니다.

[in] PolicyLength

Policy 매개 변수가 가리키는 구조체의 길이(바이트)입니다.

반환 값

ClfsMgmtInstallPolicy 루틴은 다음 NTSTATUS 값 중 하나를 반환합니다.

반환 코드 설명
STATUS_SUCCESS
 정책이 설치되었습니다.
STATUS_INVALID_PARAMETER_1
 LogFile 매개 변수에 대해 NULL 값이 제공되었습니다.
STATUS_INVALID_PARAMETER_2
 Policy 매개 변수에 대해 NULL 값이 제공되었습니다.
STATUS_INVALID_PARAMETER_3
 PolicyLength 매개 변수의 값은 CLFS_MGMT_POLICY 구조체의 instance 크기보다 작습니다.
STATUS_NOT_SUPPORTED
 Policy 매개 변수가 가리키는 CLFS_MGMT_POLICY_STRUCTUREPolicyFlags 멤버는 LOG_POLICY_OVERWRITE 이외의 플래그를 지정합니다.
STATUS_INVALID_PARAMETER
 다음 조건 중 하나 이상이 true일 경우:
  • Policy 매개 변수의 Version 멤버가 CLFS_MGMT_POLICY_VERSION 같지 않습니다.
  • Policy 매개 변수의 값은 ClfsMgmtPolicyInvalid와 같습니다.
  • Policy 매개 변수의 PolicyFlags 멤버는 LOG_POLICY_OVERWRITE 이외의 플래그를 지정합니다.
STATUS_LOG_POLICY_ALREADY_INSTALLED
 로그에 이 유형의 정책이 이미 있으며 LOG_POLICY_OVERWRITE 플래그가 설정되지 않았습니다.
STATUS_INSUFFICIENT_RESOURCES
 메모리가 부족하여 작업을 완료할 수 없습니다.
 

이 루틴은 다른 NTSTATUS 값을 반환할 수도 있습니다.

설명

정책은 휘발성입니다. 로그에 대한 모든 핸들이 닫혀 있으면 정책이 손실됩니다. 첫 번째 클라이언트를 등록할 때마다 정책을 설치해야 합니다.

로그의 첫 번째 컨테이너를 만들기 전에 PolicyType 멤버가 ClfsMgmtPolicyNewContainerSize와 같은 CLFS_MGMT_POLICY 구조체만 등록해야 합니다. 후속 등록은 무시됩니다.

설치된 로그 정책은 LogFile 매개 변수가 로그 스트림을 지정하는 경우에도 실제 로그에 적용됩니다.

요구 사항

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

추가 정보

CLFS_MGMT_POLICY