Fonction RtlUpcaseUnicodeToOemN (ntifs.h)

Article
02/26/2024

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

Syntaxe

NTSYSAPI NTSTATUS RtlUpcaseUnicodeToOemN(
  [out]           PCHAR  OemString,
  [in]            ULONG  MaxBytesInOemString,
  [out, optional] PULONG BytesInOemString,
  [in]            PCWCH  UnicodeString,
  [in]            ULONG  BytesInUnicodeString
);

Paramètres

[out] OemString

Pointeur vers une mémoire tampon allouée à l’appelant pour recevoir la chaîne traduite.

[in] MaxBytesInOemString

Nombre maximal d’octets à écrire dans OemString.

[out, optional] BytesInOemString

Pointeur vers une variable allouée par l’appelant qui reçoit le nombre d’octets dans la chaîne traduite. Ce paramètre peut être NULL.

[in] UnicodeString

Pointeur vers la chaîne source Unicode à traduire.

[in] BytesInUnicodeString

Taille, en octets, de la chaîne dans UnicodeString.

Valeur retournée

RtlUnicodeToOemN retourne STATUS_SUCCESS si la chaîne complète dans UnicodeString a été correctement traduite, convertie en majuscules et retournée dans OemString. Sinon, elle peut retourner STATUS_BUFFER_OVERFLOW si la chaîne de destination doit être tronquée pour correspondre à la valeur MaxBytesInOemString donnée.

Remarques

Pour la valeur de retour STATUS_BUFFER_OVERFLOW, la chaîne tronquée dans OemString a été traduite sans erreur.

Pour la valeur de retour STATUS_SUCCESS, la valeur de BytesInOemString, le cas échéant, indique la longueur de la chaîne retournée, plutôt que la valeur MaxBytesInOemString donnée.

Cette routine ne modifie pas la chaîne source. Elle retourne une chaîne OEM terminée par null si l’objet BytesInUnicodeString donné incluait un terminateur NULL et si la valeur MaxBytesInOemString donnée n’a pas causé de troncation.

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