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 |
---|---|
|
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 |