Fungsi SetSecurityDescriptorControl (securitybaseapi.h)
Fungsi SetSecurityDescriptorControl mengatur bit kontrol deskriptor keamanan. Fungsi ini hanya dapat mengatur bit kontrol yang terkait dengan pewarisan otomatis ACE. Untuk mengatur bit kontrol lain dari deskriptor keamanan, gunakan fungsi, seperti SetSecurityDescriptorDacl, untuk memodifikasi komponen deskriptor keamanan.
Sintaks
BOOL SetSecurityDescriptorControl(
[in] PSECURITY_DESCRIPTOR pSecurityDescriptor,
[in] SECURITY_DESCRIPTOR_CONTROL ControlBitsOfInterest,
[in] SECURITY_DESCRIPTOR_CONTROL ControlBitsToSet
);
Parameter
[in] pSecurityDescriptor
Penunjuk ke struktur SECURITY_DESCRIPTOR yang informasi kontrol dan revisinya ditetapkan.
[in] ControlBitsOfInterest
Masker SECURITY_DESCRIPTOR_CONTROL yang menunjukkan bit kontrol yang akan diatur.
[in] ControlBitsToSet
Masker SECURITY_DESCRIPTOR_CONTROL yang menunjukkan nilai baru untuk bit kontrol yang ditentukan oleh masker ControlBitsOfInterest.
Menampilkan nilai
Jika fungsi berhasil, nilai yang dikembalikan bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Fungsi SetSecurityDescriptorControl menentukan bit kontrol atau bit untuk dimodifikasi, dan apakah bit aktif atau nonaktif.
Contoh
Contoh berikut menandai DACL pada deskriptor keamanan sebagai dilindungi.
SetSecurityDescriptorControl( &SecDesc,
SE_DACL_PROTECTED, SE_DACL_PROTECTED );
Contoh berikut menandai DACL sebagai tidak dilindungi.
SetSecurityDescriptorControl( &SecDesc,
SE_DACL_PROTECTED, 0 );
Persyaratan
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