Fungsi ClfsMgmtInstallPolicy (wdm.h)

  • Artikel

Rutinitas ClfsMgmtInstallPolicy menambahkan struktur CLFS_MGMT_POLICY ke log fisik.

Sintaks

CLFSUSER_API NTSTATUS ClfsMgmtInstallPolicy(
  [in] PLOG_FILE_OBJECT  LogFile,
  [in] PCLFS_MGMT_POLICY Policy,
  [in] ULONG             PolicyLength
);

Parameter

[in] LogFile

Penunjuk ke struktur LOG_FILE_OBJECT yang mewakili log CLFS yang akan diterapkan oleh instans struktur CLFS_MGMT_POLICY ini. Kebijakan ini berlaku untuk semua aliran dalam log, bahkan jika satu aliran dalam log ditentukan.

[in] Policy

Penunjuk ke struktur CLFS_MGMT_POLICY yang berisi kebijakan yang akan diinstal.

[in] PolicyLength

Panjangnya, dalam byte, dari struktur yang ditujukkan oleh parameter Kebijakan .

Nilai kembali

Rutinitas ClfsMgmtInstallPolicy mengembalikan salah satu nilai NTSTATUS berikut:

Menampilkan kode Deskripsi
STATUS_SUCCESS
 Kebijakan telah diinstal.
STATUS_INVALID_PARAMETER_1
 Nilai NULL disediakan untuk parameter LogFile .
STATUS_INVALID_PARAMETER_2
 Nilai NULL disediakan untuk parameter Kebijakan .
STATUS_INVALID_PARAMETER_3
 Nilai parameter PolicyLength kurang dari ukuran instans struktur CLFS_MGMT_POLICY .
STATUS_NOT_SUPPORTED
 Anggota PolicyFlags dari CLFS_MGMT_POLICY_STRUCTURE yang ditunjukkan oleh parameter Policy menentukan bendera apa pun selain LOG_POLICY_OVERWRITE.
STATUS_INVALID_PARAMETER
 Salah satu kondisi berikut ini benar:
  • Anggota Versi parameter Policy tidak sama dengan CLFS_MGMT_POLICY_VERSION.
  • Nilai parameter Policy sama dengan ClfsMgmtPolicyInvalid.
  • Anggota PolicyFlags parameter Policy menentukan bendera apa pun selain LOG_POLICY_OVERWRITE.
STATUS_LOG_POLICY_ALREADY_INSTALLED
 Log sudah memiliki kebijakan jenis ini, dan bendera LOG_POLICY_OVERWRITE tidak diatur.
STATUS_INSUFFICIENT_RESOURCES
 Memori tidak cukup untuk menyelesaikan operasi.
 

Rutinitas ini mungkin juga mengembalikan Nilai NTSTATUS lainnya.

Keterangan

Kebijakan bersifat volatil. Ketika semua handel ke log ditutup, kebijakan akan hilang. Anda harus menginstal kebijakan setiap kali mendaftarkan klien pertama.

Anda hanya boleh mendaftarkan struktur CLFS_MGMT_POLICY yang anggota PolicyType-nya sama dengan ClfsMgmtPolicyNewContainerSize sebelum kontainer pertama dalam log dibuat. Setiap pendaftaran berikutnya diabaikan.

Kebijakan log yang diinstal berlaku untuk log fisik, bahkan jika parameter LogFile menentukan aliran log.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia di Windows Server 2003 R2, Windows Vista, dan versi Windows yang lebih baru.
Target Platform Desktop
Header wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

Lihat juga

CLFS_MGMT_POLICY