Fonction RtlAppendUnicodeToString (wdm.h)

  • Article

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
STATUS_SUCCESS
 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.
STATUS_BUFFER_TOO_SMALL
 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.

Voir aussi

RtlAppendUnicodeStringToString