Fonction RtlInitializeSid (ntifs.h)

  • Article

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