Fungsi SetSecurityDescriptorControl (securitybaseapi.h)

Artikel
08/25/2023

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