GetSecurityDescriptorGroup, fonction (securitybaseapi.h)

Article
03/04/2024

La fonction GetSecurityDescriptorGroup récupère les informations du groupe principal à partir d’un descripteur de sécurité.

Syntaxe

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

Paramètres

[in] pSecurityDescriptor

Pointeur vers une structure SECURITY_DESCRIPTOR dont la fonction récupère les informations de groupe principal.

[out] pGroup

Pointeur vers un pointeur vers un identificateur de sécurité (SID) qui identifie le groupe principal lorsque la fonction retourne. Si le descripteur de sécurité ne contient pas de groupe principal, la fonction définit le pointeur pointé par pGroup sur NULL et ignore le paramètre de sortie restant, lpbGroupDefaulted. Si le descripteur de sécurité contient un groupe principal, la fonction définit le pointeur vers lequel pGroup pointe vers l’adresse du SID de groupe du descripteur de sécurité et fournit une valeur valide pour la variable pointée par lpbGroupDefaulted.

[out] lpbGroupDefaulted

Pointeur vers un indicateur défini sur la valeur de l’indicateur SE_GROUP_DEFAULTED dans la structure SECURITY_DESCRIPTOR_CONTROL lorsque la fonction retourne. Si la valeur stockée dans la variable pointée par le paramètre pGroup est NULL, aucune valeur n’est définie.

Valeur retournée

Si la fonction réussit, la fonction retourne une valeur différente de zéro.

Si la fonction échoue, elle retourne zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	securitybaseapi.h (inclure Windows.h)
Bibliothèque	Advapi32.lib
DLL	Advapi32.dll