RtlUnicodeStringToOemString-Funktion (winternl.h)

Artikel
03/04/2024

Konvertiert die angegebene Unicode-Quellzeichenfolge in eine OEM-Zeichenfolge. Die Übersetzung erfolgt in Bezug auf die OEM-Codepage (OCP).

Syntax

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

Parameter

[out] DestinationString

Ein Zeiger auf eine OEM_STRING-Struktur , die das OEM-Äquivalent zur Unicode-Quellzeichenfolge enthält. Das Feld MaximumLength wird festgelegt, wenn AllocateDestinationStringauf TRUE festgelegt ist.

[in] SourceString

Ein Zeiger auf eine UNICODE_STRING Struktur, die in OEM konvertiert werden soll.

[in] AllocateDestinationString

Steuert die Zuordnung des Pufferbereichs für die Zielzeichenfolge.

true

Pufferspeicherplatz wird für DestinationString zugeordnet. Wenn dieser Wert auf TRUE festgelegt ist, muss die Zuordnung des Puffers mithilfe von RtlFreeOemString aufgehoben werden.

false

Pufferspeicherplatz wird für DestinationString nicht zugewiesen.

Rückgabewert

Die verschiedenen NTSTATUS-Werte werden in NTSTATUS definiert. H, das mit dem Windows DDK verteilt wird.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Unicode-Zeichenfolge wurde in OEM konvertiert. Andernfalls wurde kein Speicher zugewiesen, und es wurde keine Konvertierung durchgeführt.

Hinweise

Diese Routine weist nur einen Puffer für destinationString zu.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winternl.h
Bibliothek	ntdll.lib
DLL	ntdll.dll

Freigeben über