RtlCreateUnicodeString-Funktion (ntifs.h)

  • Artikel

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

Weitere Informationen

RtlFreeUnicodeString

UNICODE_STRING