Metode ChangeSecurityPermissionsEx dari kelas Win32_PageFile
Metode kelas ChangeSecurityPermissionsExWMI mengubah izin keamanan untuk file penomoran logis yang ditentukan di jalur objek (metode ini adalah versi diperluas dari metode ChangeSecurityPermissions ). Jika file logis adalah direktori, maka metode ini rekursif, dan mengubah izin keamanan semua file dan subdirektori yang dikandung direktori.
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]
-
Ekspresi yang diselesaikan ke instans Win32_SecurityDescriptor. Parameter ini berisi izin keamanan baru untuk instans Win32_PageFile.
-
Opsi [in]
-
Hak istimewa keamanan untuk dimodifikasi. Misalnya, untuk mengubah keamanan pemilik dan daftar kontrol akses diskresi (DACL), gunakan hal berikut:
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 DACL file logis.
-
CHANGE_SACL_SECURITY_INFORMATION (8)
-
Ubah daftar kontrol akses sistem (SACL) dari file logis.
StopFileName [out]
Nama file atau direktori tempat metode ChangeSecurityPermissionsEx gagal. Parameter ini adalah NULL jika metode berhasil.
StartFileName [dalam, opsional]
Menamai file atau direktori anak yang akan digunakan sebagai titik awal untuk ChangeSecurityPermissionsEx. Biasanya, parameter StartFileName adalah parameter StartFileName yang menentukan file atau direktori tempat kesalahan terjadi dari panggilan metode sebelumnya. Jika parameter ini null, operasi dilakukan pada file atau direktori yang ditentukan dalam panggilan ExecMethod .
Rekursif [in, opsional]
Jika true, perubahan kepemilikan diterapkan secara rekursif ke file dan direktori dalam direktori yang ditentukan oleh instans CIM_LogicalFile .
Catatan
Untuk instans file, parameter Rekursif diabaikan.
Mengembalikan nilai
Mengembalikan nilai 0 (nol) jika izin diubah, dan angka yang berbeda untuk menunjukkan kesalahan.
-
Berhasil
-
0
Permintaan berhasil.
-
Akses Ditolak
-
2
Akses ditolak.
-
Kegagalan yang tidak ditentukan
-
8
Terjadi kegagalan yang tidak ditentukan.
-
Objek tidak valid
-
9
Nama yang ditentukan tidak valid.
-
Objek sudah ada
-
10
Objek yang ditentukan sudah ada.
-
Sistem file bukan NTFS
-
11
Sistem file bukan sistem file NTFS.
-
Platform bukan NT/Windows 2000
-
12
Platform ini bukan Windows.
-
Drive tidak sama
-
13
Drive tidak sama.
-
Direktori tidak kosong
-
14
Direktori tidak kosong.
-
Pelanggaran berbagi
-
15
Ada pelanggaran berbagi.
-
File mulai tidak valid
-
16
File mulai yang ditentukan tidak valid.
-
Hak istimewa tidak ditahan
-
17
Hak istimewa yang diperlukan untuk operasi hilang.
-
Parameter tidak valid
-
21
Parameter yang ditentukan tidak valid.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung |
Windows Vista |
| Server minimum yang didukung |
Windows Server 2008 |
| Ruang nama |
Root\CIMV2 |
| MOF |
|
| DLL |
|