Funzione RtlInitStringEx (wdm.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 | Disponibile a partire da Windows 10. |
| Piattaforma di destinazione | Universale |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | Vedere la sezione Osservazioni. |