struktur CLFS_MGMT_POLICY (wdm.h)
Struktur CLFS_MGMT_POLICY menyimpan deskripsi kebijakan untuk mengelola log CLFS.
Sintaks
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;
Anggota
Version
Versi struktur CLFS_MGMT_POLICY . Atur ini ke CLFS_MGMT_POLICY_VERSION.
LengthInBytes
Panjang struktur CLFS_MGMT_POLICY .
PolicyFlags
Bendera yang berlaku untuk instans struktur CLFS_MGMT_POLICY ini. Satu-satunya bendera yang telah diterapkan untuk rilis ini adalah LOG_POLICY_OVERWRITE, yang menunjukkan bahwa ketika kebijakan diinstal, itu akan menggantikan kebijakan dengan jenis yang sama, jika kebijakan seperti itu sudah ada.
PolicyType
Nilai enumerasi CLFS_MGMT_POLICY_TYPE yang memasok jenis instans ini dari struktur CLFS_MGMT_POLICY .
PolicyParameters
Serikat pekerja yang memberikan informasi terperinci tentang instans struktur CLFS_MGMT_POLICY ini.
PolicyParameters.MaximumSize
Struktur yang menyediakan informasi terperinci tentang kebijakan yang PolicyType-nya adalah ClfsMgmtPolicyMaximumSize.
PolicyParameters.MaximumSize.Containers
Jumlah maksimum kontainer yang akan digunakan log.
PolicyParameters.MinimumSize
Struktur yang menyediakan informasi terperinci tentang kebijakan yang PolicyType-nya adalah ClfsMgmtPolicyMinimumSize.
PolicyParameters.MinimumSize.Containers
Jumlah minimum kontainer yang akan digunakan log.
PolicyParameters.NewContainerSize
Struktur yang menyediakan informasi terperinci tentang kebijakan yang PolicyType-nya adalah ClfsMgmtPolicyNewContainerSize.
PolicyParameters.NewContainerSize.SizeInBytes
Ukuran masing-masing kontainer log.
PolicyParameters.GrowthRate
Struktur yang menyediakan informasi terperinci tentang kebijakan yang PolicyType-nya adalah ClfsMgmtPolicyGrowthRate.
PolicyParameters.GrowthRate.AbsoluteGrowthInContainers
Jumlah kontainer yang harus ditambahkan ketika ukuran log ditingkatkan. Jika anggota RelativeGrowthPercentage bukan nol, maka AbsoluteGrowthInContainers harus nol.
PolicyParameters.GrowthRate.RelativeGrowthPercentage
Persentase di mana ukuran log harus meningkat ketika log tumbuh, dinyatakan sebagai angka antara nol dan 100. Misalnya, jika log terdiri dari 32 kontainer dan RelativeGrowthPercentage adalah sepuluh, maka, ketika log perlu tumbuh, log akan tumbuh sebesar tiga (32 * 10 persen, dibulatkan ke bawah ke kontainer bilangan bulat terdekat). Jika anggota AbsoluteGrowthInContainers bukan nol, maka RelativeGrowthPercentage harus nol.
PolicyParameters.LogTail
Struktur yang menyediakan informasi terperinci tentang kebijakan yang PolicyType-nya adalah ClfsMgmtPolicyLogTail.
PolicyParameters.LogTail.MinimumAvailablePercentage
Ketika manajemen CLFS memberi tahu klien untuk memindahkan ekor lognya, itu akan menentukan bahwa ekor dipindahkan ke LSN yang meninggalkan setidaknya persentase MinimumAvailablePercentage dari log gratis. Jika anggota MinimumAvailableContainers bukan nol, maka MinimumAvailablePercentage harus nol.
PolicyParameters.LogTail.MinimumAvailableContainers
Ketika manajemen CLFS memberi tahu klien untuk memindahkan ekor lognya, itu akan menentukan bahwa ekor dipindahkan ke LSN yang membiarkan setidaknya kontainer MinimumAvailableContainers gratis. Jika anggota MinimumAvailablePercentage bukan nol, maka MinimumAvailableContainers harus nol.
PolicyParameters.AutoShrink
Struktur yang menyediakan informasi terperinci tentang kebijakan yang PolicyType-nya adalah ClfsMgmtPolicyAutoShrink.
PolicyParameters.AutoShrink.Percentage
Ketika persentase ruang kosong dalam log mencapai Persentase, log akan menyusut. Persentase dinyatakan sebagai angka antara 0 dan 100, sehingga nilai 25 berarti 25 persen.
PolicyParameters.AutoGrow
Struktur yang memberikan informasi terperinci tentang kebijakan yang PolicyType-nya adalah ClfsMgmtPolicyAutoGrow.
PolicyParameters.AutoGrow.Enabled
Nilai numerik yang menentukan apakah pertumbuhan log otomatis diaktifkan. Nilai bukan nol apa pun memungkinkan pertumbuhan otomatis.
PolicyParameters.NewContainerPrefix
Struktur yang menyediakan informasi terperinci tentang kebijakan yang PolicyType-nya adalah ClfsMgmtPolicyNewContainerPrefix.
PolicyParameters.NewContainerPrefix.PrefixLengthInBytes
Panjangnya, dalam byte, dari anggota PrefixString .
PolicyParameters.NewContainerPrefix.PrefixString[1]
String karakter lebar yang berisi jalur lengkap ke direktori tempat kontainer log berada, serta awalan yang akan digunakan sebagai bagian dari nama file untuk setiap kontainer dalam log.
PolicyParameters.NewContainerSuffix
Struktur yang memberikan informasi terperinci tentang kebijakan yang PolicyType-nya adalah ClfsMgmtPolicyNewContainerSuffix.
PolicyParameters.NewContainerSuffix.NextContainerSuffix
Angka yang digunakan sebagai akhiran nama file untuk kontainer berikutnya dalam log. Untuk membentuk nama file, angka dikonversi ke string digit desimal dan ditambahkan ke string awalan. Angka tersebut bertahap untuk nama file setiap kontainer berikutnya.
PolicyParameters.NewContainerExtension
Struktur yang memberikan informasi terperinci tentang kebijakan yang PolicyType-nya adalah ClfsMgmtPolicyNewContainerExtension.
PolicyParameters.NewContainerExtension.ExtensionLengthInBytes
Panjang, dalam byte, dari anggota ExtensionString .
PolicyParameters.NewContainerExtension.ExtensionString[1]
String karakter lebar yang berisi ekstensi ke nama file untuk setiap kontainer dalam log. Nama file kontainer dibuat menggunakan format [awalan][akhiran][.extension]. Ekstensi bersifat opsional. Ekstensi default adalah string kosong.
Keterangan
Cara struktur CLFS_MGMT_POLICY ditafsirkan tergantung pada jenis kebijakan yang dipegang struktur.
Anda dapat memberikan kebijakan yang menentukan bagaimana log akan dikelola. Setiap kebijakan adalah instans struktur CLFS_MGMT_POLICY , tetapi strukturnya ditafsirkan secara berbeda tergantung pada jenis kebijakan. CLFS menggunakan informasi yang Anda berikan dalam kebijakan untuk menyesuaikan caranya mengelola log.
Saat Anda membuat struktur CLFS_MGMT_POLICY yang PolicyType-nya adalah ClfsMgmtPolicyNewContainerPrefix, pastikan untuk mengalokasikan cukup ruang untuk menahan string PolicyParameters.NewContainerPrefix.PrefixString .
Anda hanya dapat menginstal kebijakan yang jenis kebijakannya ditentukan dalam nilai PolicyType adalah ClfsMgmtPolicyNewContainerSize sebelum ada kontainer dalam log. Anda dapat mengubah kebijakan lain setelah log ada.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header | wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h) |
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk