Funzione RtlInitStringEx (ntifs.h)

La routine RtlInitStringEx inizializza una stringa con conteggiata di caratteri a 8 bit.

Sintassi

NTSYSAPI NTSTATUS RtlInitStringEx(
  [out]          PSTRING               DestinationString,
  [in, optional] __drv_aliasesMem PCSZ SourceString
);

Parametri

[out] DestinationString

Puntatore alla struttura STRING da inizializzare. Il file di intestazione Ntdef.h definisce questa struttura in modo che sia identica alla struttura ANSI_STRING .

[in, optional] SourceString

Puntatore a una stringa di caratteri con terminazione Null. Questa stringa viene utilizzata per inizializzare la stringa con conteggiata a cui punta DestinationString.

Valore restituito

Restituisce STATUS_NAME_TOO_LONG se SourceString è troppo lungo. In caso contrario, questa routine restituisce STATUS_SUCCESS.

Commenti

Questa routine inizializza una stringa di caratteri con conteggio.

La routine copia il valore del puntatore SourceString nel membro Buffer della struttura STRING a cui punta DestinationString. Il membro Length di questa struttura viene impostato sulla lunghezza, espressa in byte, della stringa di origine, esclusa la terminazione Null. Il membro MaximumLength della struttura viene impostato sulla lunghezza, espressa 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 a cui punta 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.
Piattaforma di destinazione	Universale
Intestazione	ntifs.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	Vedere la sezione Osservazioni.

Vedi anche

ANSI_STRING