Fungsi AddMandatoryAce (securitybaseapi.h)
Fungsi AddMandatoryAce menambahkan entri kontrol akses (ACE) SYSTEM_MANDATORY_LABEL_ACE ke daftar kontrol akses sistem (SACL) yang ditentukan.
Sintaks
BOOL AddMandatoryAce(
[in, out] PACL pAcl,
[in] DWORD dwAceRevision,
[in] DWORD AceFlags,
[in] DWORD MandatoryPolicy,
[in] PSID pLabelSid
);
Parameter
[in, out] pAcl
Penunjuk ke SACL. Fungsi ini menambahkan ACE wajib ke akhir SACL ini. ACE dalam bentuk struktur SYSTEM_MANDATORY_LABEL_ACE .
[in] dwAceRevision
Tingkat revisi SACL sedang dimodifikasi. Nilai ini bisa menjadi salah satu nilai berikut.
Nilai | Makna |
---|---|
|
SACL tidak berisi ACE khusus objek. |
|
SACL berisi ACE yang ditentukan objek. |
[in] AceFlags
Sekumpulan bendera bit yang mengontrol pewarisan ACE. Fungsi ini menetapkan bendera ini di anggota AceFlags dari struktur ACE_HEADER ACE baru.
Parameter ini bisa menjadi kombinasi dari nilai berikut.
[in] MandatoryPolicy
Kebijakan akses untuk prinsipal dengan tingkat integritas wajib lebih rendah dari objek yang terkait dengan SACL yang berisi ACE ini.
[in] pLabelSid
Penunjuk ke SID yang menentukan tingkat integritas wajib objek yang terkait dengan SACL yang ditambahkan.
Nilai kembali
Jika fungsi berhasil, fungsi akan mengembalikan TRUE.
Jika fungsi gagal, fungsi akan mengembalikan FALSE. Untuk informasi kesalahan yang diperluas, hubungi GetLastError. Berikut ini adalah kemungkinan nilai kesalahan.
Mengembalikan kode/nilai | Deskripsi |
---|---|
|
ACE baru tidak masuk ke dalam buffer pAcl . |
Keterangan
Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, tentukan _WIN32_WINNT sebagai 0x0600 atau yang lebih baru. Untuk informasi selengkapnya, lihat Menggunakan Header Windows.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows Vista [aplikasi desktop | Aplikasi UWP] |
Server minimum yang didukung | Windows Server 2008 [aplikasi desktop | Aplikasi UWP] |
Target Platform | Windows |
Header | securitybaseapi.h (termasuk WinBase.h) |
Pustaka | Advapi32.lib |
DLL | Advapi32.dll |