ClfsMgmtSetLogFileSizeAsClient 함수(wdm.h)

  • 아티클

ClfsMgmtSetLogFileSizeAsClient 루틴은 클라이언트 로그에 컨테이너를 추가하거나 클라이언트 로그에서 컨테이너를 삭제하여 로그 파일 크기를 설정합니다.

구문

CLFSUSER_API NTSTATUS ClfsMgmtSetLogFileSizeAsClient(
  [in]            PLOG_FILE_OBJECT                     LogFile,
  [in, optional]  PCLFS_MGMT_CLIENT                    ClientCookie,
  [in]            PULONGLONG                           NewSizeInContainers,
  [out, optional] PULONGLONG                           ResultingSizeInContainers,
  [in, optional]  PCLFS_SET_LOG_SIZE_COMPLETE_CALLBACK CompletionRoutine,
  [in, optional]  PVOID                                CompletionRoutineData
);

매개 변수

[in] LogFile

CLFS(Common Log File System) 로그 또는 컨테이너가 추가 또는 삭제되는 로그 내의 스트림을 나타내는 LOG_FILE_OBJECT 구조체 에 대한 포인터입니다. 이 매개 변수의 값은 ClfsCreateLogFile 루틴에 대한 호출을 통해 가져옵니다.

[in, optional] ClientCookie

클라이언트에서 제공하는 쿠키에 대한 포인터입니다. 이 매개 변수의 값은 ClfsMgmtRegisterManagedClient 루틴에 대한 호출을 통해 얻은 CLFS_MGMT_CLIENT 구조체여야 합니다.

[in] NewSizeInContainers

컨테이너 수로 표현되는 원하는 로그 크기입니다. 로그 파일에 대한 컨테이너는 최대 1,024개일 수 있습니다.

[out, optional] ResultingSizeInContainers

컨테이너 수로 표현된 로그의 실제 크기입니다.

[in, optional] CompletionRoutine

사용되지 않습니다.

[in, optional] CompletionRoutineData

사용되지 않습니다.

반환 값

ClfsMgmtSetLogFileSizeAsClient 루틴은 NTSTATUS 값을 반환합니다.

반환 코드 설명
STATUS_SUCCESS
 로그 파일 크기가 설정되었습니다.
STATUS_INVALID_PARAMETER_1
 LogFile 매개 변수의 값이 NULL이거나 NewSizeInContainers 매개 변수의 내용이 1입니다.
STATUS_INVALID_PARAMETER_2
 NewSizeInContainers 매개 변수의 값은 NULL입니다.
STATUS_LOG_POLICY_INVALID
 설치된 로그 정책 세트가 잘못되었습니다. 이는 잘못된 ClfsMgmtPolicyAutoShrink 정책 또는 ClfsMgmtPolicyMaximumSize 정책 때문일 수 있습니다.
STATUS_COULD_NOT_RESIZE_LOG
 CLFS 관리는 NewSizeInContainers의 값에 도달하기에 충분한 컨테이너를 삭제할 수 없습니다.
STATUS_LOG_POLICY_CONFLICT
 지정된 로그에 대한 정책으로 인해 작업이 완료되지 않습니다. CLFS 관리가 NewSizeInContainers의 값에 도달하기에 충분한 컨테이너를 로그에 추가할 수 없는 경우에 발생할 수 있습니다. 이는 클라이언트가 설정한 정책과 충돌하기 때문일 수 있습니다.
 

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

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7 및 이후 버전의 Windows에서 사용할 수 있습니다.
대상 플랫폼 데스크톱
머리글 wdm.h
DLL Clfs.sys

추가 정보

CLFS 관리 라이브러리 루틴