Fonction RtlUnicodeStringToAnsiString (wdm.h)

  • Article

La routine RtlUnicodeStringToAnsiString convertit une chaîne Unicode donnée en chaîne ANSI.

Syntaxe

NTSYSAPI NTSTATUS RtlUnicodeStringToAnsiString(
  [in, out] PANSI_STRING     DestinationString,
  [in]      PCUNICODE_STRING SourceString,
  [in]      BOOLEAN          AllocateDestinationString
);

Paramètres

[in, out] DestinationString

Pointeur vers une structure ANSI_STRING pour contenir la chaîne ANSI 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.

[in] SourceString

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

[in] 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 RtlFreeAnsiString.

Valeur retournée

Si la conversion réussit, RtlUnicodeStringToAnsiString retourne STATUS_SUCCESS. Sinon, aucun stockage n’a été alloué et aucune conversion n’a été effectuée.

Remarques

La traduction est effectuée conformément aux informations actuelles sur les paramètres régionaux du système.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible à partir de Windows 2000.
Plateforme cible Universal
En-tête wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

Voir aussi

ANSI_STRING

RtlAnsiStringToUnicodeString

RtlFreeAnsiString

UNICODE_STRING