Funzione RtlCreateUnicodeString (ntifs.h)

  • Articolo

La routine RtlCreateUnicodeString crea una nuova stringa Unicode conteggiata.

Sintassi

NTSYSAPI BOOLEAN RtlCreateUnicodeString(
  [out] PUNICODE_STRING DestinationString,
  [in]  PCWSTR          SourceString
);

Parametri

[out] DestinationString

Puntatore alla stringa Unicode appena allocata e inizializzata.

[in] SourceString

Puntatore a una stringa Unicode con terminazione null con cui inizializzare la nuova stringa.

Valore restituito

RtlCreateUnicodeString restituisce TRUE se la stringa Unicode è stata creata correttamente, FALSE in caso contrario.

Commenti

DestinationString viene allocato dal pool di pagine. Il chiamante è responsabile della liberazione di DestinationString chiamando RtlFreeUnicodeString.

Per informazioni su altre routine di gestione delle stringhe, vedere le funzioni di manipolazione delle stringhe nelle routine RTL (Run-Time Library).

Requisiti

Requisito Valore
Client minimo supportato Windows 2000
Piattaforma di destinazione Universale
Intestazione ntifs.h (include Ntifs.h)
Libreria NtosKrnl.lib
DLL NtosKrnl.exe (modalità kernel); Ntdll.dll (modalità utente)
IRQL PASSIVE_LEVEL

Vedi anche

RtlFreeUnicodeString

UNICODE_STRING