Fonction RtlUTF8StringToUnicodeString (wdm.h)

  • Article

La fonction RtlUTF8StringToUnicodeString convertit la chaîne source UTF8 spécifiée en chaîne Unicode conformément aux informations de paramètres régionaux système actuelles.

Syntaxe

NTSYSAPI NTSTATUS RtlUTF8StringToUnicodeString(
  PUNICODE_STRING DestinationString,
  PUTF8_STRING    SourceString,
  BOOLEAN         AllocateDestinationString
);

Paramètres

DestinationString

Pointeur vers une structure UNICODE_STRING pour contenir la chaîne Unicode convertie.

Si AllocateDestinationString a la valeur TRUE, la routine alloue une nouvelle mémoire tampon pour contenir les données de chaîne, met à jour le membre tampon de DestinationString pour qu’il pointe vers la nouvelle mémoire tampon et définit le champ de longueur maximale. Sinon, la routine utilise la mémoire tampon spécifiée pour contenir la chaîne.

SourceString

Pointeur vers la chaîne UTF8 à convertir en Unicode.

AllocateDestinationString

Spécifie si cette routine doit allouer l’espace tampon pour la chaîne de destination. Si c’est le cas, l’appelant doit libérer la mémoire tampon en appelant RtlFreeUnicodeString.

Valeur retournée

Si la conversion réussit, RtlUTF8StringToUnicodeString retourne STATUS_SUCCESS. En cas d’échec, la routine n’alloue pas de mémoire et n’effectue pas de conversion.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10, version 2004
En-tête wdm.h
IRQL PASSIVE_LEVEL

Voir aussi

RtlFreeUnicodeString