Fonction RtlInitializeSid (ntifs.h)

Article
02/26/2024

La routine RtlInitializeSid initialise une structure d’identificateur de sécurité (SID).

Syntaxe

NTSYSAPI NTSTATUS RtlInitializeSid(
  [out] PSID                      Sid,
  [in]  PSID_IDENTIFIER_AUTHORITY IdentifierAuthority,
  [in]  UCHAR                     SubAuthorityCount
);

Paramètres

[out] Sid

Pointeur vers une structure SID allouée par l’appelant à initialiser.

[in] IdentifierAuthority

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

[in] SubAuthorityCount

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

Valeur retournée

RtlInitializeSid retourne l’un des éléments suivants :

Code de retour	Description
STATUS_SUCCESS	Le SID a été correctement initialisé.
STATUS_INVALID_PARAMETER	La valeur SubAuthorityCount spécifiée n’est pas valide.

Remarques

Bien que RtlInitializeSid définit le nombre de sous-entités pour le SID, il ne définit pas les valeurs de sous-autorisation. Pour cela, appelez RtlSubAuthoritySid séparément.

Pour plus d’informations sur la sécurité et le contrôle d’accès, consultez Modèle de sécurité Windows pour les développeurs de pilotes et la documentation sur ces rubriques dans le Kit de développement logiciel (SDK) Windows.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000
Plateforme cible	Universal
En-tête	ntifs.h (inclure Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe (mode noyau) ; Ntdll.dll (mode utilisateur)
IRQL	< DISPATCH_LEVEL

Voir aussi

RtlSubAuthoritySid

SID

SID_IDENTIFIER_AUTHORITY

Partager via