Funzione RtlInitUTF8StringEx (ntifs.h)

  • Articolo

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

Vedi anche

ANSI_STRING