Fonction InitializeSid (securitybaseapi.h)

Article
03/01/2024

La fonction InitializeSid initialise un identificateur de sécurité (SID).

Syntaxe

BOOL InitializeSid(
  [out] PSID                      Sid,
  [in]  PSID_IDENTIFIER_AUTHORITY pIdentifierAuthority,
  [in]  BYTE                      nSubAuthorityCount
);

Paramètres

[out] Sid

Pointeur vers une structure SID à initialiser.

[in] pIdentifierAuthority

Pointeur vers une structure SID_IDENTIFIER_AUTHORITY à définir dans la structure SID .

[in] nSubAuthorityCount

Spécifie le nombre de sous-entités à définir dans le SID. Les valeurs de la sous-autorisation doivent être définies séparément, comme décrit dans la section Remarques suivante.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Bien que la fonction InitializeSid définit le nombre de sous-entités pour le SID, elle ne définit pas les valeurs de sous-autorisation. Cela doit être effectué séparément, à l’aide de fonctions telles que GetSidSubAuthority.

Une application peut utiliser la fonction AllocateAndInitializeSid pour initialiser un SID et définir ses valeurs de sous-autorisation.

Cette fonction utilise une valeur RID 32 bits. Pour les applications qui nécessitent une valeur RID plus élevée, utilisez CreateWellKnownSid.

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