Fonction RtlUnicodeStringToUTF8String (wdm.h)

La fonction RtlUnicodeStringToUTF8String convertit la chaîne source Unicode spécifiée en chaîne UTF8.

Syntaxe

NTSYSAPI NTSTATUS RtlUnicodeStringToUTF8String(
  PUTF8_STRING     DestinationString,
  PCUNICODE_STRING SourceString,
  BOOLEAN          AllocateDestinationString
);

Paramètres

DestinationString

Pointeur vers une structure UTF8_STRING pour contenir la chaîne UTF8 convertie. Si AllocateDestinationString a la valeur TRUE, la routine alloue une nouvelle mémoire tampon pour contenir les données de chaîne et met à jour le membre Buffer de DestinationString pour qu’il pointe vers la nouvelle mémoire tampon. Sinon, la routine utilise la mémoire tampon actuellement spécifiée pour contenir la chaîne. Le champ de longueur maximale est défini uniquement si AllocateDestinationString a la valeur TRUE.

SourceString

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

AllocateDestinationString

TRUE si cette routine doit allouer l’espace de mémoire tampon pour destinationString. Si c’est le cas, la mémoire tampon doit être libérée en appelant RtlFreeUTF8String.

Valeur retournée

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

Configuration requise

Voir aussi

RtlFreeUTF8String