Fungsi SetSecurityDescriptorSacl (securitybaseapi.h)

Artikel
03/15/2023

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