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 |