Fonction RtlUpcaseUnicodeToOemN (ntifs.h)

Article
02/07/2025

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 par 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 à UnicodeString .

Valeur de retour

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

Remarques

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

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

Cette routine ne modifie pas la chaîne source. Elle retourne une chaîne OEM terminée par null si l'BytesInUnicodeString donné inclus un terminateur NULL et si le MaxBytesInOemString donné n’a pas généré de troncation.

Pour plus d’informations sur les autres routines de gestion des chaînes, consultez Run-Time Routines de bibliothèque (RTL).