RtlUnicodeToOemN, fonction (ntifs.h)

La routine RtlUnicodeToOemN convertit 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 au format UnicodeString.

Valeur de retour

RtlUnicodeToOemN retourne STATUS_SUCCESS si la chaîne complète au format UnicodeString a été traduite et retournée à 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 à 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 généré de troncation.

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

Configuration requise

   
Plateforme cible Universal
En-tête ntifs.h (include Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

Voir aussi

RtlOemToUnicodeN

RtlUnicodeStringToCountedOemString

RtlUnicodeStringToOemString