Fonction RtlUpcaseUnicodeStringToOemString (ntifs.h)

Article
02/26/2024

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

Syntaxe

NTSYSAPI NTSTATUS RtlUpcaseUnicodeStringToOemString(
       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 comptabilisée. 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, RtlUpcaseUnicodeStringToOemString 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 RtlUpcaseUnicodeStringToOemString 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

RtlUpcaseUnicodeStringToOemString 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

RtlUpcaseUnicodeStringToOemString 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 et convertit la chaîne OEM en majuscules.

Cette routine peut substituer un caractère par défaut dans la chaîne de destination à tous les caractères de chaîne source qu’elle ne peut pas mapper à la page de codes active, puis retourner STATUS_SUCCESS.

Cette routine 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).