Fonction RtlOemStringToCountedUnicodeString (ntifs.h)
La routine RtlOemStringToCountedUnicodeString traduit la chaîne source spécifiée en chaîne Unicode à l’aide de la page de code OEM système actuelle.
Syntaxe
NTSYSAPI NTSTATUS RtlOemStringToCountedUnicodeString(
PUNICODE_STRING DestinationString,
[in] PCOEM_STRING SourceString,
[in] BOOLEAN AllocateDestinationString
);
Paramètres
DestinationString
Pointeur vers une mémoire tampon allouée par l’appelant pour recevoir la chaîne Unicode traduite. Si AllocateDestinationString a la valeur FALSE, l’appelant doit également allouer une mémoire tampon pour que le membre Buffer de DestinationString conserve les données Unicode. Si AllocateDestinationString a la valeur TRUE, RtlOemStringToCountedUnicodeString 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 RtlOemStringToCountedUnicodeString doit allouer l’espace tampon pour destinationString, FALSE sinon. 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
Si l’opération réussit, RtlOemStringToCountedUnicodeString retourne STATUS_SUCCESS. Sinon, aucun stockage n’a été alloué et aucune conversion n’a été effectuée.
Remarques
RtlOemStringToCountedUnicodeString retourne une chaîne traduite qui n’inclut pas de terminaison NULL. Il traduit la chaîne source donnée à l’aide de la page de code OEM qui a été installée en tant que page de code système actuelle au démarrage.
RtlOemStringToCountedUnicodeString ne modifie pas la chaîne source.
Pour plus d’informations sur d’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 (inclure Ntifs.h) |
Bibliothèque | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | < DISPATCH_LEVEL |
Voir aussi
RtlOemStringToCountedUnicodeSize