Funzione RtlCreateUnicodeString (ntifs.h)
La routine RtlCreateUnicodeString crea una nuova stringa Unicode con 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.
Osservazioni
La DestinationString viene allocata dal pool di paging. Il chiamante è responsabile della liberazione del DestinationString chiamando RtlFreeUnicodeString.
Per informazioni su altre routine di gestione delle stringhe, vedere le funzioni di manipolazione delle stringhe nelle routine della libreria di Run-Time (RTL).
Fabbisogno
| 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 |