Fonction RtlCopySid (ntifs.h)

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

Voir aussi

RtlEqualPrefixSid

RtlEqualSid

RtlLengthSid

RtlValidSid

SID