Metode ChangeSecurityPermissionsEx dari kelas CIM_Directory

Artikel
06/13/2023

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

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 ChangeSecurityPermissionsEx(
  [in]           Win32_SecurityDescriptor SecurityDescriptor,
  [in]           uint32                   Option,
  [out]          string                   StopFileName,
  [in, optional] string                   StartFileName,
  [in, optional] boolean                  Recursive
);

Parameter

SecurityDescriptor [in]

Menentukan informasi keamanan.

Catatan

ACL NULL 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 logika.

CHANGE_DACL_SECURITY_INFORMATION (4)

Ubah ACL file logis.

CHANGE_SACL_SECURITY_INFORMATION (8)

Ubah ACL sistem dari file logis.

StopFileName [out]

String yang mewakili nama file (atau direktori) tempat metode gagal. Parameter ini memiliki nilai null jika metode berhasil.

StartFileName [in, opsional]

String yang mewakili file anak (atau direktori) untuk digunakan sebagai titik awal untuk metode ini. Biasanya, parameter StartFileName adalah parameter StopFileName yang menentukan file (atau direktori) tempat kesalahan terjadi dari panggilan metode sebelumnya. Jika nilai parameter null, operasi dilakukan pada file atau direktori yang ditentukan dalam panggilan ExecMethod .

Rekursif [in, opsional]

Jika TRUE, metode ini juga diterapkan secara rekursif ke file dan direktori dalam direktori yang ditentukan oleh instans CIM_Directory . Untuk instans file, parameter ini diabaikan.

Nilai kembali

Mengembalikan nilai 0 (nol) pada keberhasilan, dan angka lainnya 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 untuk memperbaiki kesalahan kecil, sesuai dengan standar dokumentasi Microsoft SDK, atau memberikan informasi selengkapnya.

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