Partager via


GetSidLengthRequired, fonction (securitybaseapi.h)

La fonction GetSidLengthRequired retourne la longueur, en octets, de la mémoire tampon requise pour stocker un SID avec un nombre spécifié de sous-autorisations.

Syntaxe

DWORD GetSidLengthRequired(
  [in] UCHAR nSubAuthorityCount
);

Paramètres

[in] nSubAuthorityCount

Spécifie le nombre de sous-autorisations à stocker dans la structure SID .

Valeur retournée

La valeur de retour est la longueur, en octets, de la mémoire tampon requise pour stocker la structure SID . Cette fonction ne peut pas échouer.

Notes

La structure SID spécifiée dans nSubAuthorityCount utilise une valeur RID 32 bits. Pour les applications qui nécessitent des valeurs RID plus longues, utilisez CreateWellKnownSid et les fonctions associées.

Spécifications

   
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

AllocateAndInitializeSid

Fonctions Access Control de base

CreateWellKnownSid

GetLengthsid

GetSidIdentifierAuthority

GetSidSubAuthority

GetSidSubAuthorityCount

InitializeSid

IsValidSid

SID