Partager via


GetSidIdentifierAuthority, fonction (securitybaseapi.h)

La fonction GetSidIdentifierAuthority retourne un pointeur vers la structure SID_IDENTIFIER_AUTHORITY dans un identificateur de sécurité (SID) spécifié.

Syntaxe

PSID_IDENTIFIER_AUTHORITY GetSidIdentifierAuthority(
  [in] PSID pSid
);

Paramètres

[in] pSid

Pointeur vers la structure SID pour laquelle un pointeur vers la structure SID_IDENTIFIER_AUTHORITY 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 la structure SID_IDENTIFIER_AUTHORITY 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 pointée par le paramètre pSid n’est pas valide. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Cette fonction utilise une valeur RID 32 bits. Pour les applications qui nécessitent une valeur RID plus élevée, 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

GetSidLengthRequired

GetSidSubAuthority

GetSidSubAuthorityCount

IsValidSid

SID

SID_IDENTIFIER_AUTHORITY