RtlOemStringToCountedUnicodeString-Funktion (ntifs.h)
Die RtlOemStringToCountedUnicodeString-Routine übersetzt die angegebene Quellzeichenfolge mithilfe der aktuellen OEM-Codepage des Systems in eine Unicode-Zeichenfolge.
Syntax
NTSYSAPI NTSTATUS RtlOemStringToCountedUnicodeString(
PUNICODE_STRING DestinationString,
[in] PCOEM_STRING SourceString,
[in] BOOLEAN AllocateDestinationString
);
Parameter
DestinationString
Zeiger auf einen vom Aufrufer zugewiesenen Puffer, um die übersetzte Unicode-Zeichenfolge zu empfangen. Wenn AllocateDestinationStringauf FALSE festgelegt ist, muss der Aufrufer auch einen Puffer für den Buffer-Member von DestinationString zuweisen, um die Unicode-Daten zu enthalten. Wenn AllocateDestinationStringTRUE ist, weist RtlOemStringToCountedUnicodeString 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 entsprechend.
[in] SourceString
Zeiger auf die OEM-Zeichenfolge, die in Unicode übersetzt werden soll.
[in] AllocateDestinationString
Legen Sie diesen Wert auf TRUE fest, wenn RtlOemStringToCountedUnicodeString den Pufferbereich 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 RtlFreeUnicodeString aufgerufen wird.
Rückgabewert
Wenn der Vorgang erfolgreich ist, gibt RtlOemStringToCountedUnicodeString STATUS_SUCCESS zurück. Andernfalls wurde kein Speicher zugewiesen, und es wurde keine Konvertierung durchgeführt.
Hinweise
RtlOemStringToCountedUnicodeString gibt eine übersetzte Zeichenfolge zurück, die keinen NULL-Abschlusszeichen enthält. Die angegebene Quellzeichenfolge wird mithilfe der OEM-Codepage übersetzt, die zum Startzeitpunkt als aktuelle Systemcodepage installiert wurde.
RtlOemStringToCountedUnicodeString ändert die Quellzeichenfolge nicht.
Informationen zu anderen Zeichenfolgenverarbeitungsroutinen finden Sie unter Laufzeitbibliotheksroutinen (RTL).
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Universell |
Header | ntifs.h (include Ntifs.h) |
Bibliothek | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | < DISPATCH_LEVEL |
Weitere Informationen
RtlOemStringToCountedUnicodeSize