Metode ChangeSecurityPermissions dari kelas CIM_Directory

Artikel
06/03/2023

Metode ChangeSecurityPermissions mengubah izin keamanan untuk file entri direktori logis yang ditentukan di jalur objek. Jika file logis adalah direktori, maka metode ini akan bertindak secara rekursif, mengubah izin keamanan untuk semua file dan sub-direktori yang dikandung direktori. Metode ini diwarisi dari CIM_LogicalFile.

Penting

Kelas CIM (Model Informasi Umum) DMTF (Distributed Management Task Force) adalah kelas induk tempat kelas WMI dibangun. WMI saat ini hanya mendukung skema versi CIM 2.x.

Topik ini menggunakan sintaks Managed Object Format (MOF). Untuk informasi selengkapnya tentang menggunakan metode ini, lihat Memanggil Metode.

Sintaks

uint32 ChangeSecurityPermissions(
  [in] Win32_SecurityDescriptor SecurityDescriptor,
  [in] uint32                   Option
);

Parameter

SecurityDescriptor [in]

Menentukan informasi keamanan.

Catatan

Daftar kontrol akses NULL (ACL) dalam struktur SECURITY_DESCRIPTOR memberikan akses tak terbatas.

Opsi [in]

Hak istimewa keamanan untuk dimodifikasi. Misalnya, untuk mengubah pemilik dan keamanan DACL, gunakan:

Option = 1 + 4

atau

Option = CHANGE_OWNER_SECURITY_INFORMATION | CHANGE_DACL_SECURITY_INFORMATION

CHANGE_OWNER_SECURITY_INFORMATION (1)

Ubah pemilik file logis.

CHANGE_GROUP_SECURITY_INFORMATION (2)

Ubah grup file logis.

CHANGE_DACL_SECURITY_INFORMATION (4)

Ubah ACL file logis.

CHANGE_SACL_SECURITY_INFORMATION (8)

Ubah ACL sistem dari file logis.

Nilai kembali

Mengembalikan nilai 0 (nol) pada keberhasilan, dan angka lain untuk menunjukkan kesalahan.

Sukses.

Akses ditolak.

Kegagalan yang tidak ditentukan.

Objek tidak valid.

Objek sudah ada.

Sistem file bukan NTFS.

Platform bukan Windows.

Drive tidak sama.

Direktori tidak kosong.

Pelanggaran berbagi.

File mulai tidak valid.

Hak istimewa tidak ditahan.

Parameter tidak valid.

Keterangan

Metode ini saat ini tidak diimplementasikan oleh WMI. Untuk menggunakan metode ini, Anda harus menerapkannya di penyedia Anda sendiri.

Dokumentasi ini berasal dari deskripsi kelas CIM yang diterbitkan oleh DMTF. Microsoft mungkin telah membuat perubahan pada kesalahan kecil yang benar, sesuai dengan standar dokumentasi Microsoft SDK, atau memberikan informasi lebih lanjut.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Ruang nama	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Lihat juga

CIM_Directory
CIM_Directory

Bagikan melalui