Funzione RtlIntegerToUnicodeString (wdm.h)
La routine RtlIntegerToUnicodeString converte un valore intero senza segno in una stringa con terminazione Null di uno o più caratteri Unicode nella base specificata.
Sintassi
NTSYSAPI NTSTATUS RtlIntegerToUnicodeString(
[in] ULONG Value,
[in, optional] ULONG Base,
[in, out] PUNICODE_STRING String
);
Parametri
[in] Value
Specifica il valore ULONG da convertire.
[in, optional] Base
Specifica la base da utilizzare per la conversione di Value in una stringa. I valori possibili sono:
Valore | Base |
---|---|
16 | Valore esadecimale |
8 | Ottale |
2 | Binary |
0 o 10 | Decimal |
[in, out] String
Puntatore a una struttura UNICODE_STRING che riceve la rappresentazione di stringa di Value. Il buffer specificato da Buffer of String deve essere sufficientemente grande da contenere il risultato.
Valore restituito
RtlIntegerToUnicodeString restituisce un valore NTSTATUS. I valori restituiti possibili includono:
Codice restituito | Descrizione |
---|---|
|
La routine ha convertito correttamente Value in una stringa Unicode. |
|
Il valore è troppo grande per la conversione o la struttura UNICODE_STRING è troppo piccola per contenere il risultato. |
|
La codebase specificata non è valida. Gli unici valori validi sono 0, 2, 8, 10 e 16. |
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Disponibile a partire da Windows 2000. |
Piattaforma di destinazione | Universale |
Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h) |
Libreria | NtosKrnl.lib |
DLL | NtosKrnl.exe (modalità kernel); Ntdll.dll (modalità utente) |
IRQL | PASSIVE_LEVEL |