RtlOemStringToUnicodeString, fonction (ntifs.h)

La routine RtlOemStringToUnicodeString convertit 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 par l’appelant pour recevoir la chaîne traduite. Si AllocateDestinationString a la valeur FALSE, l’appelant doit également allouer une mémoire tampon pour le membre Buffer de DestinationString pour contenir 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 la longueur et les membres de longueur maximale de DestinationString en conséquence.

[in] SourceString

Pointeur vers la chaîne OEM à traduire en Unicode.

[in] AllocateDestinationString

Affectez la valeur TRUE si RtlOemStringToUnicodeString doit allouer l’espace tampon pour destinationString, sinon, FALSE . Si ce paramètre a la valeur TRUE, l’appelant est chargé de libérer la mémoire tampon lorsqu’il n’est plus nécessaire en appelant RtlFreeUnicodeString.

Valeur de retour

RtlOemStringToUnicodeString retourne STATUS_SUCCESS si elle retourne une chaîne traduite à 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 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 des chaînes, consultez Routines de bibliothèque d’exécution (RTL).

Spécifications

   
Plateforme cible Universal
En-tête ntifs.h (include Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

Voir aussi

OEM_STRING

RtlFreeUnicodeString

RtlOemStringToCountedUnicodeString

RtlOemStringToUnicodeSize

RtlOemToUnicodeN

RtlUnicodeStringToOemString

UNICODE_STRING