RtlUnicodeStringToOemString, fonction (ntifs.h)

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 par l’appelant pour recevoir la chaîne OEM. Si AllocateDestinationString est FAUX, l’appelant doit également allouer une mémoire tampon pour le membre Buffer de DestinationString pour contenir les données OEM. Si AllocateDestinationString est TRUE, RtlUnicodeStringToOemString alloue une mémoire tampon suffisamment grande pour contenir la chaîne, lui transmet un pointeur dans tampon, et met à jour la longueur et les membres de longueur maximale de DestinationString en conséquence.

[in] SourceString

Pointeur vers la chaîne Unicode à traduire.

[in] AllocateDestinationString

Défini sur TRUE si RtlUnicodeStringToOemString doit allouer l’espace tampon pour le DestinationString, FALSE dans le cas contraire. Si ce paramètre est TRUE, l’appelant est chargé de libérer la mémoire tampon lorsqu’elle n’est plus nécessaire en appelant RtlFreeOemString.

Valeur de retour

RtlUnicodeStringToOemString retourne STATUS_SUCCESS si la chaîne à 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 installée en tant que page de codes système actuelle au 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 des chaînes, consultez Run-Time Routines de bibliothèque (RTL).

Exigences

Voir aussi

OEM_STRING

RtlFreeOemString

RtlUnicodeStringToCountedOemString

RtlUnicodeStringToOemSize

RtlUnicodeToOemN

RtlUpcaseUnicodeStringToOemString

UNICODE_STRING