Fonction RtlCopyUnicodeString (wdm.h)

La routine RtlCopyUnicodeString copie une chaîne source dans une chaîne de destination.

Syntaxe

NTSYSAPI VOID RtlCopyUnicodeString(
  [in, out]      PUNICODE_STRING  DestinationString,
  [in, optional] PCUNICODE_STRING SourceString
);

Paramètres

[in, out] DestinationString

Pointeur vers la mémoire tampon de chaîne de destination. Ce paramètre pointe vers une structure UNICODE_STRING .

[in, optional] SourceString

Pointeur vers la mémoire tampon de chaîne source. Ce paramètre pointe vers une structure UNICODE_STRING .

Valeur de retour

None

Remarques

Si SourceString a la valeur NULL, cette routine définit le champ Length de la structure pointée par DestinationString sur zéro.

Cette routine ne modifie pas les champs MaximumLength et Buffer de la structure pointée vers destinationString.

Le nombre d’octets copiés à partir de la chaîne source correspond à la longueur de la chaîne source (spécifiée par le membre Length de la structure pointée vers SourceString) ou à la longueur maximale de la chaîne de destination (spécifiée par le membre MaximumLength de la structure pointée par DestinationString), selon la plus petite des deux.

L’appelant doit initialiser correctement tous les membres de la structure pointée par DestinationString avant d’appeler RtlCopyUnicodeString. L’échec de l’initialisation du membre Length ou MaximumLength avant l’appel de cette routine peut entraîner un dépassement de mémoire tampon.

Les mémoires tampons DestinationString et SourceString doivent être résidentes si l’appelant s’exécute à IRQL >= DISPATCH_LEVEL.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 2000.
Plateforme cible	Universal
En-tête	wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe (mode noyau) ; Ntdll.dll (mode utilisateur)
IRQL	N’importe quel niveau (voir la section Remarques)

Voir aussi

RtlCopyString

UNICODE_STRING