RtlUnicodeStringToCountedOemString-Funktion (ntifs.h)

Artikel
02/07/2025

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

Syntax

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

Parameter

DestinationString

Zeigen Sie auf einen vom Aufrufer zugewiesenen Puffer, um die gezählte OEM-Zeichenfolge zu erhalten. Wenn AllocateDestinationStringFALSEist, muss der Aufrufer auch einen Puffer für das Buffer Member von DestinationString- zuweisen, um die OEM-Daten aufzunehmen. Wenn AllocateDestinationStringTRUEist, RtlUnicodeStringToCountedOemString einen Puffer groß genug zuordnet, um die Zeichenfolge zu halten, übergibt einen Zeiger in Bufferund aktualisiert die Länge und die maximale Längenmember DestinationString entsprechend.

[in] SourceString

Zeigen Sie auf die zu übersetzende Unicode-Quellzeichenfolge.

[in] AllocateDestinationString

Wird auf TRUE festgelegt, wenn RtlUnicodeStringToCountedOemString den Pufferbereich für die DestinationString-FALSE- zuordnen soll. Wenn dieser Parameter TRUEist, ist der Aufrufer dafür verantwortlich, den Puffer freizuweisen, wenn er nicht mehr benötigt wird, indem RtlFreeOemStringaufgerufen wird.

Rückgabewert

RtlUnicodeStringToCountedOemString gibt STATUS_SUCCESS zurück, wenn die Zeichenfolge bei DestinationString- übersetzt wird. Andernfalls wurde kein Speicher zugewiesen, und es wurde keine Konvertierung ausgeführt. Diese Routine gibt STATUS_UNMAPPABLE_CHARACTER zurück, wenn ein Zeichen in der angegebenen SourceString-nicht übersetzt werden kann.

Bemerkungen

RtlUnicodeStringToCountedOemString gibt eine übersetzte Zeichenfolge zurück, die keinen NULL-Terminator enthält. Sie übersetzt die angegebene Quellzeichenfolge mithilfe der OEM-Codeseite, die zur Systemstartzeit als aktuelle Systemcodeseite installiert wurde.

RtlUnicodeStringToCountedOemString ändert die Quellzeichenfolge nicht.

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