RtlUnicodeToOemN-Funktion (ntifs.h)

Artikel
02/07/2025

Die RtlUnicodeToOemN Routine übersetzt eine bestimmte Unicode-Zeichenfolge in eine OEM-Zeichenfolge unter Verwendung der aktuellen System-OEM-Codeseite.

Syntax

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

Parameter

[out] OemString

Zeigen Sie 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

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

[in] UnicodeString

Zeigen Sie 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 an OemString-zurückgegeben wurde.

Bemerkungen

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 der angegebenen MaxBytesInOemStringan.

RtlUnicodeToOemN ändert die Quellzeichenfolge nicht. Es gibt eine MIT NULL beendete OEM-Zeichenfolge zurück, wenn die angegebene BytesInUnicodeString- einen NULL-Terminator enthalten und wenn die angegebene MaxBytesInOemString- keine Abkürzung verursacht hat.

Informationen zu anderen Zeichenfolgenbehandlungsroutinen finden Sie unter Run-Time Library (RTL)-Routinen.