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
Zeigen Sie auf die neu zugewiesene und initialisierte Unicode-Zeichenfolge.
[in] SourceString
Zeigen Sie auf eine mit Null beendete Unicode-Zeichenfolge, mit der die neue Zeichenfolge initialisiert werden soll.
Rückgabewert
RtlCreateUnicodeString gibt TRUE zurück, wenn die Unicode-Zeichenfolge erfolgreich erstellt wurde, FALSE andernfalls.
Bemerkungen
Die DestinationString- wird aus dem ausgelagerten Pool zugewiesen. Der Anrufer ist dafür verantwortlich, die DestinationString- durch Aufrufen von RtlFreeUnicodeStringfrei zu geben.
Informationen zu anderen Zeichenfolgenbehandlungsroutinen finden Sie in den Zeichenfolgenbearbeitungsfunktionen in Run-Time Library (RTL)-Routinen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 2000 |
| Zielplattform- | Universal |
| Header- | ntifs.h (einschließlich Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe (Kernelmodus); Ntdll.dll (Benutzermodus) |
| IRQL- | PASSIVE_LEVEL |