Fungsi SetSecurityDescriptorSacl (securitybaseapi.h)
Fungsi SetSecurityDescriptorSacl mengatur informasi dalam daftar kontrol akses sistem (SACL). Jika sudah ada SACL di deskriptor keamanan, saCL akan diganti.
Sintaks
BOOL SetSecurityDescriptorSacl(
[in, out] PSECURITY_DESCRIPTOR pSecurityDescriptor,
[in] BOOL bSaclPresent,
[in, optional] PACL pSacl,
[in] BOOL bSaclDefaulted
);
Parameter
[in, out] pSecurityDescriptor
Penunjuk ke struktur SECURITY_DESCRIPTOR tempat fungsi menambahkan SACL. Deskriptor keamanan ini harus dalam format absolut, yang berarti bahwa anggotanya harus mengarah ke struktur lain, bukan offset ke data yang bersebelahan.
[in] bSaclPresent
Menunjukkan keberadaan SACL di deskriptor keamanan. Jika parameter ini TRUE, fungsi mengatur bendera SE_SACL_PRESENT dalam struktur SECURITY_DESCRIPTOR_CONTROL dan menggunakan nilai dalam parameter pSacl dan bSaclDefaulted . Jika FALSE, fungsi tidak mengatur bendera SE_SACL_PRESENT, dan pSacl dan bSaclDefaulted diabaikan.
[in, optional] pSacl
Penunjuk ke struktur ACL yang menentukan SACL untuk deskriptor keamanan. Jika parameter ini NULL, NULL SACL ditetapkan ke deskriptor keamanan. SACL direferensikan oleh, tidak disalin ke dalam, deskriptor keamanan.
[in] bSaclDefaulted
Menunjukkan sumber SACL. Jika bendera ini TRUE, SACL telah diambil oleh beberapa mekanisme default. Jika false, SACL telah ditentukan secara eksplisit oleh pengguna. Fungsi menyimpan nilai ini di bendera SE_SACL_DEFAULTED struktur SECURITY_DESCRIPTOR_CONTROL . Jika parameter ini tidak ditentukan, bendera SE_SACL_DEFAULTED akan dihapus.
Nilai kembali
Jika fungsi berhasil, fungsi mengembalikan bukan nol.
Jika fungsi gagal, fungsi akan mengembalikan nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows XP [aplikasi desktop | Aplikasi UWP] |
Server minimum yang didukung | Windows Server 2003 [aplikasi desktop | Aplikasi UWP] |
Target Platform | Windows |
Header | securitybaseapi.h (termasuk Windows.h) |
Pustaka | Advapi32.lib |
DLL | Advapi32.dll |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk