Partager via


GetSecurityDescriptorGroup, fonction (securitybaseapi.h)

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

Voir aussi

GetSecurityDescriptorControl

GetSecurityDescriptorDacl

GetSecurityDescriptorLength

GetSecurityDescriptorOwner

GetSecurityDescriptorSacl

IsValidSecurityDescriptor

Access Control de bas niveau

Fonctions Access Control de bas niveau

SECURITY_DESCRIPTOR

SECURITY_DESCRIPTOR_CONTROL

SetSecurityDescriptorGroup