SetLogFileSizeWithPolicy 함수(clfsmgmtw32.h)
설치된 정책의 상태에 따라 로그에서 컨테이너를 추가하거나 삭제합니다.
구문
CLFSUSER_API BOOL SetLogFileSizeWithPolicy(
[in] HANDLE hLog,
[in] PULONGLONG pDesiredSize,
[out] PULONGLONG pResultingSize
);
매개 변수
[in] hLog
로그에 대한 핸들입니다.
[in] pDesiredSize
다음 값 중 하나로 표현되는 요청된 로그 크기를 지정하는 값에 대한 포인터입니다. 실제 결과 크기는 pResultingSize 매개 변수를 참조하세요.
| 값 | 의미 |
|---|---|
|
최소 크기 정책을 적용합니다.
최소 크기 정책이 설치되지 않은 경우 다음 중 하나가 발생합니다.
최소 크기 정책이 설치된 경우 다음 중 하나가 발생합니다.
자세한 내용은 InstallLogPolicy를 참조하세요. |
|
유효한 값이 아닙니다. ERROR_INVALID_PARAMETER 함수 호출이 실패합니다. |
|
컨테이너 수로 표현되는 원하는 로그 크기입니다.
이 숫자가 설치된 정책에 지정된 최소 컨테이너 수보다 작은 경우 함수 호출은 ERROR_COULD_NOT_RESIZE_LOG 함께 실패합니다. 이 숫자가 설치된 정책에 지정된 최대 컨테이너 수보다 큰 경우 로그는 정책에서 지정한 최대 컨테이너 수까지만 확장되며 함수는 오류 없이 성공합니다. |
|
최대 크기 정책이 설치되지 않으면 ERROR_LOG_POLICY_CONFLICT 함수 호출이 실패합니다.
최대 크기 정책이 설치된 경우 로그는 최대 크기 정책에 지정된 최대 컨테이너 수로 확장되고 함수는 오류 없이 성공합니다. |
[out] pResultingSize
유효한 ULONGLONG 데이터 변수에 대한 포인터는 성공 시 크기가 조정된 로그의 컨테이너 수를 받습니다.
반환 값
함수가 성공하면 반환 값이 0이 아닙니다.
함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError 함수를 호출합니다.
설명
컨테이너는 .blf 파일과 동일한 보안 특성을 사용하여 만들어지고 .blf 파일 소유자의 컨텍스트가 아닌 애플리케이션의 컨텍스트 내에서 만들어집니다. .blf 파일에 대한 자세한 내용은 로그 형식을 참조하세요. 컨테이너가 삭제되면 호출 애플리케이션의 보안 컨텍스트를 사용하여 삭제됩니다.
예제
이 함수를 사용하는 예제는 로그 파일 만들기를 참조하세요.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 R2 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | clfsmgmtw32.h |
| 라이브러리 | Clfsw32.lib |
| DLL | Clfsw32.dll |