Fonction RtlOemStringToUnicodeString (ntifs.h)
La routine RtlOemStringToUnicodeString traduit une chaîne source donnée en chaîne Unicode terminée par null à l’aide de la page de codes OEM système actuelle.
Syntaxe
NTSYSAPI NTSTATUS RtlOemStringToUnicodeString(
PUNICODE_STRING DestinationString,
[in] PCOEM_STRING SourceString,
[in] BOOLEAN AllocateDestinationString
);
Paramètres
DestinationString
Pointeur vers une mémoire tampon allouée à l’appelant pour recevoir la chaîne traduite. Si AllocateDestinationString a la valeur FALSE, l’appelant doit également allouer une mémoire tampon pour que le membre Buffer de DestinationString contienne la chaîne Unicode terminée par null. Si AllocateDestinationString a la valeur TRUE, RtlOemStringToUnicodeString alloue une mémoire tampon suffisamment grande pour contenir la chaîne, lui transmet un pointeur dans Buffer et met à jour les membres de longueur et de longueur maximale de DestinationString en conséquence.
[in] SourceString
Pointeur vers la chaîne OEM à traduire en Unicode.
[in] AllocateDestinationString
Définissez sur TRUE si RtlOemStringToUnicodeString doit allouer l’espace de mémoire tampon pour destinationString, false dans le cas contraire. Si ce paramètre a la valeur TRUE, l’appelant est chargé de libérer la mémoire tampon quand elle n’est plus nécessaire en appelant RtlFreeUnicodeString.
Valeur retournée
RtlOemStringToUnicodeString retourne STATUS_SUCCESS si elle renvoie une chaîne traduite dans DestinationString. Sinon, aucun stockage n’a été alloué et aucune conversion n’a été effectuée.
Remarques
RtlOemStringToUnicodeString traduit la chaîne source donnée à l’aide de la page de codes OEM qui a été installée en tant que page de codes système actuelle au moment du démarrage du système.
Cette routine ne modifie pas la chaîne source. Elle retourne une chaîne Unicode terminée par NULL.
Pour plus d’informations sur les autres routines de gestion de chaînes, consultez Routines de la bibliothèque d’exécution (RTL).
Configuration requise
Condition requise | Valeur |
---|---|
Plateforme cible | Universal |
En-tête | ntifs.h (include Ntifs.h) |
Bibliothèque | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | < DISPATCH_LEVEL |