Fonction RtlUpcaseUnicodeStringToCountedOemString (ntifs.h)

Article
02/29/2024

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

Syntaxe

NTSYSAPI NTSTATUS RtlUpcaseUnicodeStringToCountedOemString(
       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, RtlUpcaseUnicodeStringToCountedOemString 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

Affectez la valeur TRUE si RtlUpcaseUnicodeStringToCountedOemString 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

RtlUpcaseUnicodeStringToCountedOemString retourne STATUS_SUCCESS si elle renvoie une chaîne traduite dans DestinationString. Sinon, aucun stockage n’a été alloué et aucune conversion n’a été effectuée. Elle retourne STATUS_UNMAPPABLE_CHARACTER si elle ne peut pas traduire un caractère dans la chaîne SourceString donnée.

Remarques

RtlUpcaseUnicodeStringToCountedOemString retourne une chaîne qui n’est pas terminée par null. Il 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 démarrage du système, et convertit la chaîne traduite en majuscules.

Pour trouver un mappage de correspondance optimale pour les caractères spéciaux, tels qu’un caractère de copyright, dans la chaîne source donnée, RtlUpcaseUnicodeStringToCountedOemString effectue les opérations suivantes :

Convertit une copie de la chaîne Unicode dans SourceString en chaîne OEM
Convertit la chaîne OEM en Unicode
Convertit cette nouvelle chaîne Unicode en majuscules
Convertit la chaîne Unicode majuscule en chaîne OEM comptée et la retourne dans DestinationString

Cette routine ne modifie pas la chaîne source.

Pour plus d’informations sur les autres routines de gestion de chaînes, consultez Routines de la bibliothèque d’exécution (RTL).