Fungsi SetSecurityDescriptorGroup (securitybaseapi.h)

Artikel
03/01/2024

Fungsi SetSecurityDescriptorGroup mengatur informasi grup utama dari deskriptor keamanan berformat absolut, menggantikan informasi grup utama apa pun yang sudah ada di deskriptor keamanan.

Sintaks

BOOL SetSecurityDescriptorGroup(
  [in, out]      PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in, optional] PSID                 pGroup,
  [in]           BOOL                 bGroupDefaulted
);

Parameter

[in, out] pSecurityDescriptor

Penunjuk ke struktur SECURITY_DESCRIPTOR yang grup utamanya diatur oleh fungsi ini. Fungsi ini menggantikan grup utama yang ada dengan grup utama baru.

[in, optional] pGroup

Penunjuk ke struktur SID untuk grup utama baru deskriptor keamanan. Struktur SID direferensikan oleh, tidak disalin ke dalam, deskriptor keamanan. Jika parameter ini NULL, fungsi akan menghapus informasi grup utama deskriptor keamanan. Ini menandai deskriptor keamanan sebagai tidak memiliki grup utama.

[in] bGroupDefaulted

Menunjukkan apakah informasi grup utama berasal dari mekanisme default. Jika nilai ini TRUE, nilainya adalah informasi default, dan fungsi menyimpan nilai ini sebagai bendera SE_GROUP_DEFAULTED dalam struktur SECURITY_DESCRIPTOR_CONTROL . Jika parameter ini nol, bendera SE_GROUP_DEFAULTED akan dihapus.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah 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