CLFS_MGMT_POLICY 구조체(wdm.h)

아티클
08/08/2023

CLFS_MGMT_POLICY 구조에는 CLFS 로그를 관리하기 위한 정책에 대한 설명이 있습니다.

구문

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 구조체의 버전입니다. CLFS_MGMT_POLICY_VERSION 설정합니다.

LengthInBytes

CLFS_MGMT_POLICY 구조체의 길이입니다.

PolicyFlags

CLFS_MGMT_POLICY 구조체의 이 instance 적용되는 플래그입니다. 이 릴리스에 대해 구현된 유일한 플래그는 LOG_POLICY_OVERWRITE. 이는 정책이 설치될 때 해당 정책이 이미 있는 경우 동일한 유형의 정책을 대체한다는 것을 나타냅니다.

PolicyType

CLFS_MGMT_POLICY 구조체의 이 instance 형식을 제공하는 CLFS_MGMT_POLICY_TYPE 열거형의 값입니다.

PolicyParameters

CLFS_MGMT_POLICY 구조체의 이 instance 대한 자세한 정보를 제공하는 공용 구조체입니다.

PolicyParameters.MaximumSize

PolicyType이 ClfsMgmtPolicyMaximumSize인 정책에 대한 자세한 정보를 제공하는 구조체입니다.

PolicyParameters.MaximumSize.Containers

로그에서 사용할 최대 컨테이너 수입니다.

PolicyParameters.MinimumSize

PolicyType이 ClfsMgmtPolicyMinimumSize인 정책에 대한 자세한 정보를 제공하는 구조체입니다.

PolicyParameters.MinimumSize.Containers

로그에서 사용할 최소 컨테이너 수입니다.

PolicyParameters.NewContainerSize

PolicyType이 ClfsMgmtPolicyNewContainerSize인 정책에 대한 자세한 정보를 제공하는 구조체입니다.

PolicyParameters.NewContainerSize.SizeInBytes

각 로그 컨테이너의 크기입니다.

PolicyParameters.GrowthRate

PolicyType이 ClfsMgmtPolicyGrowthRate인 정책에 대한 자세한 정보를 제공하는 구조체입니다.

PolicyParameters.GrowthRate.AbsoluteGrowthInContainers

로그 크기를 늘릴 때 추가해야 하는 컨테이너의 수입니다. RelativeGrowthPercentage 멤버가 0이 아닌 경우 AbsoluteGrowthInContainers는 0이어야 합니다.

PolicyParameters.GrowthRate.RelativeGrowthPercentage

로그가 증가할 때 로그 크기가 증가할 백분율로, 0에서 100 사이의 숫자로 표시됩니다. 예를 들어 로그가 32개의 컨테이너로 구성되고 RelativeGrowthPercentage 가 10인 경우 로그가 증가해야 할 때 3개(32 * 10%, 가장 가까운 정수) 컨테이너로 반올림됩니다. AbsoluteGrowthInContainers 멤버가 0이 아닌 경우 RelativeGrowthPercentage는 0이어야 합니다.

PolicyParameters.LogTail

PolicyType이 ClfsMgmtPolicyLogTail인 정책에 대한 자세한 정보를 제공하는 구조체입니다.

PolicyParameters.LogTail.MinimumAvailablePercentage

CLFS 관리가 로그 꼬리를 이동하도록 클라이언트에 알릴 때 최소 값이면 로그의 최소 값이 1%를 벗어나는 LSN으로 꼬리를 이동하도록 지정합니다. MinimumAvailableContainers 멤버가 0이 아닌 경우 MinimumAvailablePercentage는 0이어야 합니다.

PolicyParameters.LogTail.MinimumAvailableContainers

CLFS 관리가 로그 꼬리를 이동하도록 클라이언트에 알릴 때 최소AvailableContainers 컨테이너를 해제하는 LSN으로 꼬리를 이동하도록 지정합니다. MinimumAvailablePercentage 멤버가 0이 아닌 경우 MinimumAvailableContainers는 0이어야 합니다.

PolicyParameters.AutoShrink

PolicyType이 ClfsMgmtPolicyAutoShrink인 정책에 대한 자세한 정보를 제공하는 구조체입니다.

PolicyParameters.AutoShrink.Percentage

로그에서 사용 가능한 공간의 백분율이 백분율에 도달하면 로그가 축소됩니다. 백분율은 0에서 100 사이의 숫자로 표현되므로 25의 값은 25%를 의미합니다.

PolicyParameters.AutoGrow

PolicyType이 ClfsMgmtPolicyAutoGrow인 정책에 대한 자세한 정보를 제공하는 구조체입니다.

PolicyParameters.AutoGrow.Enabled

자동 로그 증가를 사용할 수 있는지 여부를 결정하는 숫자 값입니다. 0이 아닌 값은 자동 증가를 가능하게 합니다.

PolicyParameters.NewContainerPrefix

PolicyType이 ClfsMgmtPolicyNewContainerPrefix인 정책에 대한 자세한 정보를 제공하는 구조체입니다.

PolicyParameters.NewContainerPrefix.PrefixLengthInBytes

PrefixString 멤버의 길이(바이트)입니다.

PolicyParameters.NewContainerPrefix.PrefixString[1]

로그의 컨테이너가 있는 디렉터리의 전체 경로와 로그의 각 컨테이너에 대한 파일 이름의 일부로 사용될 접두사를 포함하는 와이드 문자열입니다.

PolicyParameters.NewContainerSuffix

PolicyType이 ClfsMgmtPolicyNewContainerSuffix인 정책에 대한 자세한 정보를 제공하는 구조체입니다.

PolicyParameters.NewContainerSuffix.NextContainerSuffix

로그의 다음 컨테이너에 대한 파일 이름의 접미사로 사용할 번호입니다. 파일 이름을 형성하기 위해 숫자는 10진수 문자열로 변환되고 접두사 문자열에 추가됩니다. 각 후속 컨테이너의 파일 이름에 대해 숫자가 증가합니다.

PolicyParameters.NewContainerExtension

PolicyType이 ClfsMgmtPolicyNewContainerExtension인 정책에 대한 자세한 정보를 제공하는 구조체입니다.

PolicyParameters.NewContainerExtension.ExtensionLengthInBytes

ExtensionString 멤버의 길이(바이트)입니다.

PolicyParameters.NewContainerExtension.ExtensionString[1]

로그의 각 컨테이너에 대한 파일 이름에 대한 확장명을 포함하는 와이드 문자열입니다. 컨테이너 파일 이름은 [접두사][접미사][.extension] 형식을 사용하여 빌드됩니다. 확장은 선택 사항입니다. 기본 확장은 빈 문자열입니다.

설명

CLFS_MGMT_POLICY 구조체가 해석되는 방식은 구조체가 보유하는 정책 유형에 따라 달라집니다.

로그를 관리하는 방법을 지정하는 정책을 제공할 수 있습니다. 각 정책은 CLFS_MGMT_POLICY 구조의 instance 구조체는 정책 유형에 따라 다르게 해석됩니다. CLFS는 정책에서 제공한 정보를 사용하여 로그를 관리하는 방법을 조정합니다.

PolicyType이 ClfsMgmtPolicyNewContainerPrefix인 CLFS_MGMT_POLICY 구조를 만들 때 PolicyParameters.NewContainerPrefix.PrefixString 문자열을 저장할 충분한 공간을 할당해야 합니다.

로그에 컨테이너가 있기 전에 PolicyType 값에 지정된 정책 형식이 ClfsMgmtPolicyNewContainerSize 인 정책만 설치할 수 있습니다. 로그가 있는 후 다른 정책을 변경할 수 있습니다.