RtlUnicodeStringToCountedOemString-Funktion (ntifs.h)

Artikel
02/26/2024

Die RtlUnicodeStringToCountedOemString-Routine übersetzt die angegebene Unicode-Quellzeichenfolge mithilfe der aktuellen OEM-Codepage des Systems in eine gezählte OEM-Zeichenfolge.

Syntax

NTSYSAPI NTSTATUS RtlUnicodeStringToCountedOemString(
       POEM_STRING      DestinationString,
  [in] PCUNICODE_STRING SourceString,
  [in] BOOLEAN          AllocateDestinationString
);

Parameter

DestinationString

Zeiger auf einen vom Aufrufer zugewiesenen Puffer, um die gezählte OEM-Zeichenfolge zu empfangen. Wenn AllocateDestinationStringauf FALSE festgelegt ist, muss der Aufrufer auch einen Puffer für den Buffer-Member von DestinationString zuweisen, um die OEM-Daten zu enthalten. Wenn AllocateDestinationStringTRUE ist, weist RtlUnicodeStringToCountedOemString einen Puffer zu, der groß genug ist, um die Zeichenfolge zu halten, übergibt einen Zeiger darauf in Buffer und aktualisiert die Länge und maximale Länge von DestinationString-Membern entsprechend.

[in] SourceString

Zeiger auf die zu übersetzende Unicode-Quellzeichenfolge.

[in] AllocateDestinationString

Legen Sie diesen Wert auf TRUE fest, wenn RtlUnicodeStringToCountedOemString den Pufferraum für destinationString zuordnen soll, andernfalls FALSE . Wenn dieser Parameter TRUE ist, ist der Aufrufer dafür verantwortlich, den Puffer frei zu geben, wenn er nicht mehr benötigt wird, indem RtlFreeOemString aufgerufen wird.

Rückgabewert

RtlUnicodeStringToCountedOemString gibt STATUS_SUCCESS zurück, wenn die Zeichenfolge unter DestinationString übersetzt wird. Andernfalls wurde kein Speicher zugeordnet, und es wurde keine Konvertierung durchgeführt. Diese Routine gibt STATUS_UNMAPPABLE_CHARACTER zurück, wenn ein Zeichen im angegebenen SourceString nicht übersetzt werden kann.

Hinweise

RtlUnicodeStringToCountedOemString gibt eine übersetzte Zeichenfolge zurück, die kein NULL-Abschlusszeichen enthält. Die angegebene Quellzeichenfolge wird mithilfe der OEM-Codepage übersetzt, die zur Systemstartzeit als aktuelle Systemcodepage installiert wurde.

RtlUnicodeStringToCountedOemString ändert die Quellzeichenfolge nicht.

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