Fonction RtlAppendUnicodeToString (wdm.h)
La routine RtlAppendUnicodeToString concatène la chaîne Unicode fournie avec une chaîne Unicode mise en mémoire tampon.
Syntaxe
NTSYSAPI NTSTATUS RtlAppendUnicodeToString(
[in, out] PUNICODE_STRING Destination,
[in, optional] PCWSTR Source
);
Paramètres
[in, out] Destination
Pointeur vers la chaîne mise en mémoire tampon.
[in, optional] Source
Pointeur vers la chaîne terminée par null à ajouter à la chaîne de destination .
Valeur retournée
RtlAppendUnicodeToString peut retourner l’un des éléments suivants :
| Code de retour | Description |
|---|---|
|
La chaîne source a été correctement ajoutée à la chaîne de destination, et la longueur de la chaîne de destination a été mise à jour pour inclure les octets ajoutés. |
|
La mémoire tampon de chaîne de destination étant trop petite pour permettre l’ajout de la chaîne source, la longueur de la chaîne de destination n’est pas mise à jour et le contenu de la mémoire tampon de chaîne de destination n’est pas modifié. |
Remarques
RtlAppendUnicodeToString ajoute la chaîne source à la fin de la chaîne de destination.
Si la mémoire tampon de destination n’est pas assez grande pour contenir la chaîne résultant de la concaténation des chaînes source et de destination (sans inclure le caractère null qui termine la chaîne source), la routine retourne STATUS_BUFFER_TOO_SMALL et laisse la chaîne de destination inchangée.
La mémoire tampon de destination doit être résidente 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 | Consultez la section Notes. |