Fonction RtlUnicodeStringToCountedOemString (ntifs.h)

Article
02/29/2024

La routine RtlUnicodeStringToCountedOemString traduit la chaîne source Unicode spécifiée en chaîne OEM comptée à l’aide de la page de code OEM système actuelle.

Syntaxe

NTSYSAPI NTSTATUS RtlUnicodeStringToCountedOemString(
       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 comptabilisée. 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 OEM. Si AllocateDestinationString a la valeur TRUE, RtlUnicodeStringToCountedOemString 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 source à traduire.

[in] AllocateDestinationString

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

Valeur retournée

RtlUnicodeStringToCountedOemString 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. Cette routine retourne STATUS_UNMAPPABLE_CHARACTER si elle ne peut pas traduire un caractère dans la SourceString donnée.

Remarques

RtlUnicodeStringToCountedOemString 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 du système.

RtlUnicodeStringToCountedOemString 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).