Fonction RtlUnicodeStringToOemString (ntifs.h)

Article
02/29/2024

La routine RtlUnicodeStringToOemString traduit une chaîne source Unicode donnée en chaîne OEM à l’aide de la page de codes OEM système actuelle.

Syntaxe

NTSYSAPI NTSTATUS RtlUnicodeStringToOemString(
       POEM_STRING      DestinationString,
  [in] PCUNICODE_STRING SourceString,
  [in] BOOLEAN          AllocateDestinationString
);

Paramètres

DestinationString

Pointeur vers une mémoire tampon allouée à l’appelant pour recevoir la chaîne OEM. Si AllocateDestinationString a la valeur FALSE, l’appelant doit également allouer une mémoire tampon pour que le membre Buffer de DestinationString contienne les données OEM. Si AllocateDestinationString a la valeur TRUE, RtlUnicodeStringToOemString 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 Unicode à traduire.

[in] AllocateDestinationString

Définissez sur TRUE si RtlUnicodeStringToOemString 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 RtlFreeOemString.

Valeur retournée

RtlUnicodeStringToOemString retourne STATUS_SUCCESS si la chaîne dans DestinationString est traduite. Sinon, aucun stockage n’a été alloué et aucune conversion n’a été effectuée.

Remarques

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

RtlUnicodeStringToOemString ne modifie pas la chaîne source. Elle retourne une chaîne OEM 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).