Funzione RtlInitUTF8StringEx (wdm.h)
La routine 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 STRING .
SourceString
Puntatore a una stringa di caratteri con terminazione null. Questa stringa viene usata per inizializzare la stringa conteggiata a cui fa riferimento DestinationString.
Valore restituito
Restituisce STATUS_NAME_TOO_LONG se SourceString è troppo lungo. In caso contrario, questa routine restituisce STATUS_SUCCESS.
Commenti
La routine copia il valore del puntatore SourceString nel membro Buffer della struttura UTF8_STRING puntata da DestinationString. Il membro Length di questa struttura è impostato sulla lunghezza, in byte, della stringa di origine, esclusa la terminazione null. Il membro MaximumLength della struttura è impostato sulla lunghezza, in byte, della stringa di origine, inclusa la terminazione null. Se SourceString è NULL, Length e MaximumLength sono entrambi impostati su zero.
RtlInitUTF8StringEx non modifica la stringa di origine puntata da SourceString.
I chiamanti di RtlInitUTF8StringEx 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 | wdm.h |
| IRQL | <= DISPATCH_LEVEL |