Share via

Funzione WdmlibRtlInitUnicodeStringEx (wdmsec.h)

  • Articolo

La funzione WdmlibRtlInitUnicodeStringEx inizializza una stringa conteggiata di caratteri Unicode.

Sintassi

NTSTATUS WdmlibRtlInitUnicodeStringEx(
  [out]          PUNICODE_STRING DestinationString,
  [in, optional] PCWSTR          SourceString
);

Parametri

[out] DestinationString

Puntatore alla struttura UNICODE_STRING da inizializzare.

[in, optional] SourceString

Puntatore a una stringa di caratteri wide con terminazione null. Questa stringa viene usata per inizializzare la stringa conteggiata a cui fa riferimento DestinationString.

Valore restituito

WdmlibRtlInitUnicodeStringEx restituisce STATUS_SUCCESS se ha esito positivo, in caso contrario, il metodo può restituire altri valori NTSTATUS.

Commenti

La routine copia il valore del puntatore SourceString nel membro Buffer della struttura UNICODE_STRING a cui punta 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.

WdmlibRtlInitUnicodeStringEx non modifica la stringa di origine puntata da SourceString.

Nota

Se la stringa di origine è più lunga di MAX_USTRING - 1 byte, WdmlibRtlInitUnicodeStringEximposta il membro Length della struttura UNICODE_STRING puntato a DestinationString su MAX_USTRING - 2 e imposta il membro MaximumLength di questa struttura su MAX_USTRING. In questo caso, i valori Length e MaximumLength non rappresentano la lunghezza della stringa di origine con terminazione null e si basano sull'accuratezza di questi valori è potenzialmente pericoloso.

I chiamanti di WdmlibRtlInitUnicodeStringEx 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 2000.
Piattaforma di destinazione Universale
Intestazione wdmsec.h (include Wdmsec.h, Wdm.h, Ntddk.h, Ntifs.h)
Libreria NtosKrnl.lib
DLL NtosKrnl.exe
IRQL Vedere La sezione Osservazioni.

Vedi anche