Fonction RtlUnicodeStringToOemString (winternl.h)

Article
03/13/2024

Convertit la chaîne source Unicode spécifiée en chaîne OEM. La traduction est effectuée par rapport à la page de code OEM (OCP).

Syntaxe

NTSTATUS RtlUnicodeStringToOemString(
  [out] POEM_STRING      DestinationString,
  [in]  PCUNICODE_STRING SourceString,
  [in]  BOOLEAN          AllocateDestinationString
);

Paramètres

[out] DestinationString

Pointeur vers une structure OEM_STRING qui contient l’équivalent OEM de la chaîne source Unicode. Le champ MaximumLength est défini si AllocateDestinationString a la valeur TRUE.

[in] SourceString

Pointeur vers une structure UNICODE_STRING qui doit être convertie en OEM.

[in] AllocateDestinationString

Contrôle l’allocation de l’espace tampon pour la chaîne de destination.

TRUE

L’espace tampon est alloué pour DestinationString. Si la valeur est TRUE, la mémoire tampon doit être libérée à l’aide de RtlFreeOemString.

FALSE

L’espace tampon n’est pas alloué pour DestinationString.

Valeur retournée

Les différentes valeurs NTSTATUS sont définies dans NTSTATUS. H, qui est distribué avec le DDK Windows.

Code de retour	Description
STATUS_SUCCESS	La chaîne Unicode a été convertie en OEM. Sinon, aucun stockage n’a été alloué et aucune conversion n’a été effectuée.

Remarques

Cette routine alloue une mémoire tampon pour destinationString uniquement.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winternl.h
Bibliothèque	ntdll.lib
DLL	ntdll.dll

Partager via