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

Vedi anche

RtlInitAnsiString