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) |