RtlUnicodeToOemN-Funktion (ntifs.h)

Die RtlUnicodeToOemN-Routine übersetzt eine bestimmte Unicode-Zeichenfolge in eine OEM-Zeichenfolge mit der aktuellen OEM-Codeseite des Systems.

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 caller-zugeordnete Variable, die die Anzahl von Bytes in der übersetzten Zeichenfolge empfängt. Dieser Parameter kann NULL sein.

[in] UnicodeString

Zeiger auf die Unicode-Quellzeichenfolge, die übersetzt werden soll.

[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.

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 (sofern vorhanden) die Länge der zurückgegebenen Zeichenfolge anstelle der angegebenen MaxBytesInOemString an.

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

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

Anforderungen

   
Zielplattform Universell
Header ntifs.h (einschließlich Ntifs.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

Siehe auch

RtlOemToUnicodeN

RtlUnicodeStringToCountedOemString

RtlUnicodeStringToOemString