RtlUnicodeToOemN-Funktion (ntifs.h)

Artikel
02/29/2024

Die RtlUnicodeToOemN-Routine übersetzt eine bestimmte Unicode-Zeichenfolge mithilfe der aktuellen System-OEM-Codepage in eine OEM-Zeichenfolge.

Syntax

NTSYSAPI NTSTATUS RtlUnicodeToOemN(
  [out]           PCHAR  OemString,
  [in]            ULONG  MaxBytesInOemString,
  [out, optional] PULONG BytesInOemString,
  [in]            PCWCH  UnicodeString,
  [in]            ULONG  BytesInUnicodeString
);

Parameter

[out] OemString

Zeiger auf einen vom Aufrufer zugewiesenen Puffer, um die übersetzte Zeichenfolge zu empfangen.

[in] MaxBytesInOemString

Maximale Anzahl von Bytes, die in OemString geschrieben werden sollen.

[out, optional] BytesInOemString

Zeiger auf eine vom Aufrufer zugewiesene Variable, die die Anzahl von Bytes in der übersetzten Zeichenfolge empfängt. Dieser Parameter kann NULL sein.

[in] UnicodeString

Zeiger auf die zu übersetzende Unicode-Quellzeichenfolge.

[in] BytesInUnicodeString

Größe der Zeichenfolge in Bytes bei UnicodeString.

Rückgabewert

RtlUnicodeToOemN gibt STATUS_SUCCESS zurück, wenn die vollständige Zeichenfolge bei UnicodeString übersetzt und bei OemString zurückgegeben wurde.

Hinweise

Für den Rückgabewert STATUS_BUFFER_OVERFLOW wurde die abgeschnittene Zeichenfolge bei OemString ohne Fehler übersetzt.

Für den Rückgabewert STATUS_SUCCESS gibt der Wert bei BytesInOemString (falls vorhanden) die Länge der zurückgegebenen Zeichenfolge anstelle des angegebenen MaxBytesInOemString an.

RtlUnicodeToOemN ändert die Quellzeichenfolge nicht. Es gibt eine NULL-beendete OEM-Zeichenfolge zurück, wenn der angegebene BytesInUnicodeString einen NULL-Abschlussator enthält und wenn der angegebene MaxBytesInOemString keine Abschneidung verursacht hat.

Informationen zu anderen Zeichenfolgenbehandlungsroutinen finden Sie unter Laufzeitbibliotheksroutinen (RTL).