Fungsi GetSecurityDescriptorGroup (securitybaseapi.h)

Artikel
03/04/2024

Fungsi GetSecurityDescriptorGroup mengambil informasi grup utama dari deskriptor keamanan.

Sintaks

BOOL GetSecurityDescriptorGroup(
  [in]  PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [out] PSID                 *pGroup,
  [out] LPBOOL               lpbGroupDefaulted
);

Parameter

[in] pSecurityDescriptor

Penunjuk ke struktur SECURITY_DESCRIPTOR yang informasi grup utamanya diambil fungsi.

[out] pGroup

Penunjuk ke penunjuk ke pengidentifikasi keamanan (SID) yang mengidentifikasi grup utama saat fungsi kembali. Jika deskriptor keamanan tidak berisi grup utama, fungsi mengatur penunjuk yang ditunjukkan oleh pGroup ke NULL dan mengabaikan parameter output yang tersisa, lpbGroupDefaulted. Jika deskriptor keamanan berisi grup utama, fungsi mengatur penunjuk yang ditunjukkan oleh pGroup ke alamat SID grup deskriptor keamanan dan memberikan nilai yang valid untuk variabel yang ditunjukkan oleh lpbGroupDefaulted.

[out] lpbGroupDefaulted

Penunjuk ke bendera yang diatur ke nilai bendera SE_GROUP_DEFAULTED dalam struktur SECURITY_DESCRIPTOR_CONTROL saat fungsi kembali. Jika nilai yang disimpan dalam variabel yang diacu oleh parameter pGroup adalah NULL, tidak ada nilai yang diatur.

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