Fonction RtlUnicodeToOemN (ntifs.h)

Article
02/26/2024

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 à 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 d’UnicodeString a été traduite et retournée dans OemString.

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.

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