RtlCreateUnicodeString-Funktion (ntifs.h)
Die RtlCreateUnicodeString-Routine erstellt eine neue gezählte Unicode-Zeichenfolge.
Syntax
NTSYSAPI BOOLEAN RtlCreateUnicodeString(
[out] PUNICODE_STRING DestinationString,
[in] PCWSTR SourceString
);
Parameter
[out] DestinationString
Zeiger auf die neu zugeordnete und initialisierte Unicode-Zeichenfolge.
[in] SourceString
Zeiger auf eine Unicode-Zeichenfolge mit NULL-Endung, mit der die neue Zeichenfolge initialisiert werden soll.
Rückgabewert
RtlCreateUnicodeString gibt TRUE zurück, wenn die Unicode-Zeichenfolge erfolgreich erstellt wurde, andernfalls FALSE .
Hinweise
Die DestinationString wird aus einem ausgelagerten Pool zugeordnet. Der Aufrufer ist für die Freigabe von DestinationString durch Aufrufen von RtlFreeUnicodeString verantwortlich.
Informationen zu anderen Zeichenfolgenbehandlungsroutinen finden Sie unter Zeichenfolgenbearbeitungsfunktionen in RTL-Routinen (Run-Time Library).
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 2000 |
Zielplattform | Universell |
Header | ntifs.h (include Ntifs.h) |
Bibliothek | NtosKrnl.lib |
DLL | NtosKrnl.exe (Kernelmodus); Ntdll.dll (Benutzermodus) |
IRQL | PASSIVE_LEVEL |