Fonction RtlAppendUnicodeStringToString (wdm.h)

  • Article

La routine RtlAppendUnicodeStringToString concatène deux chaînes Unicode.

Syntaxe

NTSYSAPI NTSTATUS RtlAppendUnicodeStringToString(
  [in, out] PUNICODE_STRING  Destination,
  [in]      PCUNICODE_STRING Source
);

Paramètres

[in, out] Destination

Pointeur vers une chaîne Unicode mise en mémoire tampon.

[in] Source

Pointeur vers la chaîne mise en mémoire tampon à concaténér.

Valeur retournée

RtlAppendUnicodeStringToString 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 comptée de destination. La longueur de la chaîne de destination est mise à jour pour inclure les octets ajoutés.
STATUS_BUFFER_TOO_SMALL
 La longueur de la chaîne de destination est trop petite pour permettre la concaténéité de la chaîne source. Par conséquent, la longueur de la chaîne de destination n’est pas mise à jour.

Remarques

RtlAppendUnicodeStringToString copie les octets de la source vers la chaîne de destination spécifiée, une fois que le contenu actuel de la chaîne de destination et la longueur de destination ont été incrémentés par le nombre d’octets copiés.

Les mémoires tampons destination et source 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
IRQL Consultez la section Notes.

Voir aussi

RtlAppendUnicodeToString