CLFS_MGMT_POLICY 구조체(clfsmgmt.h)
CLFS_MGMT_POLICY 구조는 CLFS(Common Log File System) 관리 정책을 지정합니다. PolicyType 멤버는 정책에 사용되는 멤버를 지정합니다.
구문
typedef struct _CLFS_MGMT_POLICY {
ULONG Version;
ULONG LengthInBytes;
ULONG PolicyFlags;
CLFS_MGMT_POLICY_TYPE PolicyType;
union {
struct {
ULONG Containers;
} MaximumSize;
struct {
ULONG Containers;
} MinimumSize;
struct {
ULONG SizeInBytes;
} NewContainerSize;
struct {
ULONG AbsoluteGrowthInContainers;
ULONG RelativeGrowthPercentage;
} GrowthRate;
struct {
ULONG MinimumAvailablePercentage;
ULONG MinimumAvailableContainers;
} LogTail;
struct {
ULONG Percentage;
} AutoShrink;
struct {
ULONG Enabled;
} AutoGrow;
struct {
USHORT PrefixLengthInBytes;
WCHAR PrefixString[1];
} NewContainerPrefix;
struct {
ULONGLONG NextContainerSuffix;
} NewContainerSuffix;
struct {
USHORT ExtensionLengthInBytes;
WCHAR ExtensionString[1];
} NewContainerExtension;
} PolicyParameters;
} CLFS_MGMT_POLICY, *PCLFS_MGMT_POLICY;
멤버
Version
애플리케이션이 컴파일되는 로그 관리자 헤더의 버전을 지정합니다.
이 설정을 CLFS_MGMT_POLICY_VERSION.
LengthInBytes
전체 구조체의 길이를 지정합니다.
PolicyFlags
예약되어 있습니다. 0을 지정합니다.
PolicyType
특정 정책에 사용되는 멤버를 지정합니다. 유효한 값은 CLFS_MGMT_POLICY_TYPE 지정됩니다.
PolicyParameters
이 구조체에서 설명하는 특정 정책을 지정합니다.
PolicyParameters.MaximumSize
로그의 최대 크기를 지정합니다.
PolicyParameters.MaximumSize.Containers
로그의 최대 크기를 컨테이너 수로 지정합니다. 기본 최대값은 없습니다.
PolicyParameters.MinimumSize
로그의 최소 크기를 지정합니다.
PolicyParameters.MinimumSize.Containers
로그의 최소 크기를 여러 컨테이너로 지정합니다. 최소 크기는 2개 컨테이너입니다.
PolicyParameters.NewContainerSize
새 컨테이너의 크기를 제어합니다.
PolicyParameters.NewContainerSize.SizeInBytes
생성된 새 컨테이너의 크기(바이트)를 지정합니다.
PolicyParameters.GrowthRate
로그의 증가 속도를 제어합니다. 증가율은 상대 백분율 또는 추가된 컨테이너의 절대 수일 수 있지만 둘 다 사용할 수는 없습니다. 유효한 값은 0 이상입니다. 로그 크기가 증가하지 않도록 하려면 0을 지정합니다.
PolicyParameters.GrowthRate.AbsoluteGrowthInContainers
증가율을 절대 컨테이너 수로 지정합니다. 이 멤버의 기본값은 2입니다.
PolicyParameters.GrowthRate.RelativeGrowthPercentage
증가율을 상대적 백분율로 지정합니다. 이 멤버의 기본값은 없습니다.
PolicyParameters.LogTail
요청을 LOG_TAIL_ADVANCE_CALLBACK 공간의 양을 제어합니다. 값은 상대 백분율 또는 절대 바이트 수이지만 둘 다 아닙니다. 값은 항상 가장 가까운 컨테이너로 반올림됩니다. 기본 로그 꼬리를 진행하기 위해 아무 작업도 수행되지 않음을 나타내려면 0을 지정합니다.
PolicyParameters.LogTail.MinimumAvailablePercentage
전체 로그의 백분율로 요청되는 공간의 양을 지정합니다. 요청된 최소 금액은 컨테이너의 공간을 확보합니다.
PolicyParameters.LogTail.MinimumAvailableContainers
절대 컨테이너 수로 요청되는 공간의 양을 지정합니다.
PolicyParameters.AutoShrink
로그 축소 기능의 타이밍을 제어합니다. 이 값은 자동 축소 작업을 트리거하기 위해 존재해야 하는 여유 공간의 백분율을 나타냅니다. 로그는 ClfsMgmtPolicyMinimumSize 정책에 지정된 값보다 작은 크기로 축소할 수 없습니다.
PolicyParameters.AutoShrink.Percentage
로그를 축소할 백분율을 지정합니다. 기본값은 없습니다.
PolicyParameters.AutoGrow
자동 증가 기능을 제어합니다. 자동 증가가 사용하도록 설정된 경우 로그는 GrowthRate 멤버의 값에 따라 증가하며 로그가 하나 또는 전혀 없는 컨테이너가 없는 상태에 도달하면 MaximumSize 멤버의 값으로 제한됩니다.
PolicyParameters.AutoGrow.Enabled
자동 증가 정책을 사용할 수 있는지 여부를 지정합니다. 자동 증가 정책을 사용하지 않도록 설정하려면 0을 지정합니다. 기본적으로 이 옵션은 사용하지 않도록 설정됩니다.
PolicyParameters.NewContainerPrefix
새 컨테이너에 지정된 접두사를 제어합니다.
PolicyParameters.NewContainerPrefix.PrefixLengthInBytes
PrefixString의 길이를 지정합니다.
PolicyParameters.NewContainerPrefix.PrefixString[1]
접두사 문자열을 지정합니다. 이 문자열에는 컨테이너가 만들어지는 디렉터리의 전체 경로와 컨테이너 이름에 대한 접두사를 포함해야 합니다.
컨테이너의 기본 경로는 기본 로그를 포함하는 디렉터리입니다. 기본값은 "Container"입니다. 로그 컨테이너는 로그><기본 접두사><번호>의 이름으로 <만들어집니다.
PolicyParameters.NewContainerSuffix
새 컨테이너에 지정된 접미사를 제어합니다.
PolicyParameters.NewContainerSuffix.NextContainerSuffix
새 컨테이너에 지정된 접미사를 지정합니다.
PolicyParameters.NewContainerExtension
새 컨테이너에 지정된 확장을 제어합니다.
PolicyParameters.NewContainerExtension.ExtensionLengthInBytes
ExtensionString의 길이를 지정합니다.
PolicyParameters.NewContainerExtension.ExtensionString[1]
컨테이너 파일에 지정된 확장자를 지정합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 R2 [데스크톱 앱만 해당] |
| 머리글 | clfsmgmt.h |