Fungsi GetSecurityDescriptorGroup (securitybaseapi.h)
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 |