Win32 API 日本語リファレンス
ホーム › Storage.FileSystem › CLFS_MGMT_POLICY

CLFS_MGMT_POLICY

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 24 バイト / x86: 20 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールド型サイズx64x86説明
VersionDWORD4+0+0

アプリケーションのコンパイルに使用されたログマネージャーヘッダーのバージョンを指定します。

CLFS_MGMT_POLICY_VERSION を設定してください。

LengthInBytesDWORD4+4+4構造体全体の長さを指定します。
PolicyFlagsDWORD4+8+8予約済みです。0 を指定します。
PolicyTypeCLFS_MGMT_POLICY_TYPE4+12+12特定のポリシーで使用されるメンバーを指定します。有効な値は CLFS_MGMT_POLICY_TYPE で規定されています。
PolicyParameters_PolicyParameters_e__Union8/4+16+16この構造体が記述する具体的なポリシーを指定します。

共用体: _PolicyParameters_e__Union x64 8B / x86 4B

フィールド型サイズx64x86説明
MaximumSize_MaximumSize_e__Struct8/4+0+0ログの最大サイズを指定します。
MinimumSize_MinimumSize_e__Struct8/4+0+0ログの最小サイズを指定します。
NewContainerSize_NewContainerSize_e__Struct8/4+0+0新しいコンテナーのサイズを制御します。
GrowthRate_GrowthRate_e__Struct8/4+0+0ログの拡張率を制御します。拡張率は相対的な割合か、追加するコンテナーの絶対数のいずれかで指定でき、両方を同時に指定することはできません。有効な値は 0 以上です。ログのサイズを拡張しない場合は 0 を指定します。
LogTail_LogTail_e__Struct8/4+0+0LOG_TAIL_ADVANCE_CALLBACK が要求する領域の量を制御します。値は相対的な割合か、絶対的なバイト数のいずれかであり、両方を同時に指定することはできません。値は常に最も近いコンテナー単位に切り上げられます。ベースログのテールを進める処理を行わない場合は 0 を指定します。
AutoShrink_AutoShrink_e__Struct8/4+0+0ログ縮小機能のタイミングを制御します。この値は、自動縮小操作を開始するために必要な空き領域の割合を表します。ログは ClfsMgmtPolicyMinimumSize ポリシーで指定された値より小さいサイズには縮小できません。
AutoGrow_AutoGrow_e__Struct8/4+0+0自動拡張機能を制御します。自動拡張が有効な場合、空きコンテナーが 1 個以下の状態になると、ログは GrowthRate メンバーの値に従って拡張され、MaximumSize メンバーの値によって上限が制限されます。
NewContainerPrefix_NewContainerPrefix_e__Struct8/4+0+0新しいコンテナーに付与されるプレフィックスを制御します。
NewContainerSuffix_NewContainerSuffix_e__Struct8/4+0+0新しいコンテナーに付与されるサフィックスを制御します。
NewContainerExtension_NewContainerExtension_e__Struct8/4+0+0新しいコンテナーに付与される拡張子を制御します。

公式ドキュメント

CLFS_MGMT_POLICY 構造体は、Common Log File System (CLFS) の管理ポリシーを指定します。PolicyType メンバーは、ポリシーで使用されるメンバーを指定します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// CLFS_MGMT_POLICY  (x64 24 / x86 20 バイト)
typedef struct CLFS_MGMT_POLICY {
    DWORD Version;
    DWORD LengthInBytes;
    DWORD PolicyFlags;
    CLFS_MGMT_POLICY_TYPE PolicyType;
    _PolicyParameters_e__Union PolicyParameters;
} CLFS_MGMT_POLICY;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CLFS_MGMT_POLICY
{
    public uint Version;
    public uint LengthInBytes;
    public uint PolicyFlags;
    public int PolicyType;
    public _PolicyParameters_e__Union PolicyParameters;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CLFS_MGMT_POLICY
    Public Version As UInteger
    Public LengthInBytes As UInteger
    Public PolicyFlags As UInteger
    Public PolicyType As Integer
    Public PolicyParameters As _PolicyParameters_e__Union
End Structure
import ctypes
from ctypes import wintypes

class CLFS_MGMT_POLICY(ctypes.Structure):
    _fields_ = [
        ("Version", wintypes.DWORD),
        ("LengthInBytes", wintypes.DWORD),
        ("PolicyFlags", wintypes.DWORD),
        ("PolicyType", ctypes.c_int),
        ("PolicyParameters", _PolicyParameters_e__Union),
    ]
#[repr(C)]
pub struct CLFS_MGMT_POLICY {
    pub Version: u32,
    pub LengthInBytes: u32,
    pub PolicyFlags: u32,
    pub PolicyType: i32,
    pub PolicyParameters: _PolicyParameters_e__Union,
}
import "golang.org/x/sys/windows"

type CLFS_MGMT_POLICY struct {
	Version uint32
	LengthInBytes uint32
	PolicyFlags uint32
	PolicyType int32
	PolicyParameters _PolicyParameters_e__Union
}
type
  CLFS_MGMT_POLICY = record
    Version: DWORD;
    LengthInBytes: DWORD;
    PolicyFlags: DWORD;
    PolicyType: Integer;
    PolicyParameters: _PolicyParameters_e__Union;
  end;
const CLFS_MGMT_POLICY = extern struct {
    Version: u32,
    LengthInBytes: u32,
    PolicyFlags: u32,
    PolicyType: i32,
    PolicyParameters: _PolicyParameters_e__Union,
};
type
  CLFS_MGMT_POLICY {.bycopy.} = object
    Version: uint32
    LengthInBytes: uint32
    PolicyFlags: uint32
    PolicyType: int32
    PolicyParameters: _PolicyParameters_e__Union
struct CLFS_MGMT_POLICY
{
    uint Version;
    uint LengthInBytes;
    uint PolicyFlags;
    int PolicyType;
    _PolicyParameters_e__Union PolicyParameters;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; CLFS_MGMT_POLICY サイズ: 20 バイト(x86)
dim st, 5    ; 4byte整数×5(構造体サイズ 20 / 4 切り上げ)
; Version : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; LengthInBytes : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; PolicyFlags : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; PolicyType : CLFS_MGMT_POLICY_TYPE (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; PolicyParameters : _PolicyParameters_e__Union (+16, 4byte)  varptr(st)+16 を基点に操作(4byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CLFS_MGMT_POLICY サイズ: 24 バイト(x64)
dim st, 6    ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; Version : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; LengthInBytes : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; PolicyFlags : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; PolicyType : CLFS_MGMT_POLICY_TYPE (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; PolicyParameters : _PolicyParameters_e__Union (+16, 8byte)  varptr(st)+16 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global CLFS_MGMT_POLICY
    #field int Version
    #field int LengthInBytes
    #field int PolicyFlags
    #field int PolicyType
    #field byte PolicyParameters 8
#endstruct

stdim st, CLFS_MGMT_POLICY        ; NSTRUCT 変数を確保
st->Version = 100
mes "Version=" + st->Version
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。