Fonction RtlUnicodeStringToAnsiString (winternl.h)

Convertit la chaîne source Unicode spécifiée en chaîne ANSI.

Syntaxe

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

Paramètres

[in, out] DestinationString

Pointeur vers une structure de 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 de mémoire tampon 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

La structure UNICODE_STRING qui contient la chaîne source à convertir en ANSI.

[in] AllocateDestinationString

Contrôle l’allocation de l’espace tampon pour destinationString.

TRUE

L’espace tampon est alloué pour DestinationString. Si la valeur est TRUE, la mémoire tampon doit être libérée à l’aide de RtlFreeAnsiString.

FALSE

L’espace tampon n’est pas alloué pour DestinationString.

Valeur retournée

Les différentes valeurs NTSTATUS sont définies dans NTSTATUS. H, qui est distribué avec le DDK.

Code de retour	Description
STATUS_SUCCESS	La chaîne Unicode a été convertie en ANSI. Sinon, aucun stockage n’a été alloué et aucune conversion n’a été effectuée.

Remarques

La traduction est effectuée en ce qui concerne les informations de paramètres régionaux système actuelles.

Étant donné qu’il n’existe aucune bibliothèque d’importation pour cette fonction, vous devez utiliser GetProcAddress.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winternl.h
Bibliothèque	ntdll.lib
DLL	ntdll.dll ; NtosKrnl.exe