Fonction RtlCopySid (ntifs.h)

Article
02/27/2024

La routine RtlCopySid copie la valeur d’un identificateur de sécurité (SID) dans une mémoire tampon.

Syntaxe

NTSYSAPI NTSTATUS RtlCopySid(
  [in] ULONG DestinationSidLength,
  [in] PSID  DestinationSid,
  [in] PSID  SourceSid
);

Paramètres

[in] DestinationSidLength

Longueur, en octets, de la mémoire tampon à recevoir la copie du SID.

[in] DestinationSid

Pointeur vers une mémoire tampon allouée par l’appelant pour recevoir une copie de la structure SID source. La mémoire tampon doit être au moins sizeof(SID),

[in] SourceSid

Pointeur vers la structure SID source à copier.

Valeur retournée

RtlCopySid retourne STATUS_SUCCESS si le SID a été correctement copié. Sinon, elle retourne une valeur NTSTATUS telle que l’une des valeurs suivantes :

Code de retour	Description
STATUS_BUFFER_TOO_SMALL	La mémoire tampon DestinationSid n’était pas assez grande pour recevoir une copie du SID.

Remarques

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
Plateforme cible	Universal
En-tête	ntifs.h (include Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe (mode noyau) ; Ntdll.dll (mode utilisateur)
IRQL	<= APC_LEVEL