Fonction RtlUnicodeToOemN (ntifs.h)

Article
02/07/2025

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

Syntaxe

NTSYSAPI NTSTATUS RtlUnicodeToOemN(
  [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é traduite et retournée à OemString.

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.

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