GetSidLengthRequired, fonction (securitybaseapi.h)

Article
08/25/2023

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