Partager via


Fonction GetSidSubAuthority (securitybaseapi.h)

La fonction GetSidSubAuthority retourne un pointeur vers une sous-autorisation spécifiée dans un identificateur de sécurité (SID). La valeur de sous-autorisation est un identificateur relatif (RID).

Syntaxe

PDWORD GetSidSubAuthority(
  [in] PSID  pSid,
  [in] DWORD nSubAuthority
);

Paramètres

[in] pSid

Pointeur vers la structure SID à partir de laquelle un pointeur vers une sous-autorisation doit être 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.

[in] nSubAuthority

Spécifie une valeur d’index identifiant l’élément de tableau de sous-autorisation dont l’adresse sera retournée par la fonction. La fonction n’effectue aucun test de validation sur cette valeur. Une application peut appeler la fonction GetSidSubAuthorityCount pour découvrir la plage de valeurs acceptables.

Valeur retournée

Si la fonction réussit, la valeur de retour est un pointeur vers la sous-autorisation SID spécifiée. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

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 ou si la valeur d’index spécifiée par le paramètre nSubAuthority est hors limites.

Remarques

La structure SID spécifiée dans pSid utilise une valeur RID 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

Fonctions Access Control de base

CreateWellKnownSid

GetLengthsid

GetSidIdentifierAuthority

GetSidLengthRequiredred

GetSidSubAuthorityCount

IsValidSid

SID