GetSidSubAuthorityCount, fonction (securitybaseapi.h)
La fonction GetSidSubAuthorityCount retourne un pointeur vers le membre dans une structure d’identificateur de sécurité (SID) qui contient le nombre de sous-autorisations.
Syntaxe
PUCHAR GetSidSubAuthorityCount(
[in] PSID pSid
);
Paramètres
[in] pSid
Pointeur vers la structure SID à partir de laquelle un pointeur vers le nombre de sous-autorisation est retourné.
Cette fonction ne gère pas les structures SID qui ne sont pas valides. Appelez la fonction IsValidSid pour vérifier que la structure SID est valide avant d’appeler cette fonction.
Valeur retournée
Si la fonction réussit, la valeur de retour est un pointeur vers le nombre de sous-authentifications pour la structure SID spécifiée.
Si la fonction échoue, la valeur de retour n’est pas définie. La fonction échoue si la structure SID spécifiée n’est pas valide. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
La structure SID spécifiée dans pSid utilise une valeur 32 bits. Pour les applications qui nécessitent des valeurs RID plus longues, utilisez CreateWellKnownSid et les fonctions associées.
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
Vue d’ensemble du contrôle d’accès