Funzione RtlInitUTF8StringEx (ntifs.h)
RtlInitUTF8StringEx inizializza una stringa conteggiata di caratteri UTF-8.
Sintassi
NTSYSAPI NTSTATUS RtlInitUTF8StringEx(
PUTF8_STRING DestinationString,
__drv_aliasesMem PCSZ SourceString
);
Parametri
DestinationString
Puntatore alla struttura UTF8_STRING da inizializzare. Il file di intestazione ntdef.h definisce questa struttura come identica alla struttura ANSI_STRING .
SourceString
Puntatore a una stringa di caratteri con terminazione null. SourceString viene usato per inizializzare la stringa conteggiata a cui DestinationString punta.
Valore restituito
RtlInitUTF8StringEx restituisce STATUS_NAME_TOO_LONG se sourceString è troppo lungo. In caso contrario, questa routine restituisce STATUS_SUCCESS.
Commenti
RtlInitUTF8StringEx imposta i membri della struttura UTF8_STRING a cui DestinationString punta come indicato di seguito:
Copia il valore del puntatore di SourceString nel membro Buffer .
Imposta il membro Length sulla lunghezza, in byte, della stringa di origine, esclusa la terminazione null.
Imposta il membro MaximumLength sulla lunghezza, in byte, della stringa di origine, inclusa la terminazione null.
Se SourceString è NULL, Length e MaximumLength sono entrambi impostati su zero.
RtlInitStringEx non modifica la stringa di origine puntata da SourceString.
I chiamanti di RtlInitStringEx possono essere eseguiti in IRQL <= DISPATCH_LEVEL se il buffer DestinationString non è impaginabile. In genere, i chiamanti vengono eseguiti in IRQL = PASSIVE_LEVEL perché la maggior parte delle altre routine RtlXxxString non può essere chiamata in IRQL > PASSIVE_LEVEL.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 10, versione 2004 |
| Intestazione | ntifs.h |