Funzione RtlCreateUnicodeString (ntifs.h)
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 |