Funzione RtlIntegerToUnicodeString (wdm.h)

  • Articolo

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
STATUS_SUCCESS
 La routine ha convertito correttamente Value in una stringa Unicode.
STATUS_BUFFER_OVERFLOW
 Il valore è troppo grande per la conversione o la struttura UNICODE_STRING è troppo piccola per contenere il risultato.
STATUS_INVALID_PARAMETER
 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

Vedi anche

RtlAppendUnicodeStringToString

RtlUnicodeStringToInteger

UNICODE_STRING