Fonction RtlUnicodeStringToAnsiString (wdm.h)
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 |