Funzione RtlUnicodeStringToInteger (wdm.h)

La routine RtlUnicodeStringToInteger converte una rappresentazione di stringa Unicode di un numero nel valore intero equivalente.

Sintassi

NTSYSAPI NTSTATUS RtlUnicodeStringToInteger(
  [in]           PCUNICODE_STRING String,
  [in, optional] ULONG            Base,
  [out]          PULONG           Value
);

Parametri

[in] String

Puntatore a una struttura UNICODE_STRING che contiene la rappresentazione numerica da convertire nel valore intero equivalente.

[in, optional] Base

Valore numerico che indica la base (o il numero radix) del numero rappresentato dalla stringa Unicode. Questo valore di parametro è facoltativo e può essere impostato su zero.

Se Base è zero, RtlUnicodeStringToInteger controlla il prefisso della stringa Unicode per determinare la base del numero:

• Se il prefisso è "0x", RtlUnicodeStringToInteger interpreta il numero nella stringa come intero esadecimale.

• Se il prefisso è "0o", RtlUnicodeStringToInteger interpreta il numero nella stringa come intero ottale.

• Se il prefisso è "0b", RtlUnicodeStringToInteger interpreta il numero nella stringa come intero binario.

Se la stringa Unicode non contiene alcuno di questi prefissi, RtlUnicodeStringToInteger considera la stringa come integer base-10.

[out] Value

Puntatore a una variabile ULONG in cui RtlUnicodeStringToInteger scrive il valore intero risultante dalla conversione della stringa Unicode.

Valore restituito

Se la conversione ha esito positivo, la routine RtlUnicodeStringToInteger restituisce STATUS_SUCCESS e imposta *Value sul valore intero rappresentato dal numero nella stringa Unicode. Se la stringa non è vuota, ma non inizia con una rappresentazione numerica valida, la routine restituisce STATUS_SUCCESS e imposta *Value su zero. Se la stringa è vuota, la routine ha esito negativo e restituisce STATUS_INVALID_PARAMETER.

Commenti

Questa routine ignora gli spazi vuoti all'inizio della stringa di input per trovare l'inizio del numero.

Se il primo carattere non vuoto nella stringa è un trattino (-), il valore intero scritto in *Value è negativo; in caso contrario, se il primo carattere è "+" o non è presente alcun carattere di segno, il valore intero scritto in *Value è positivo.

Se la stringa non contiene un numero valido o se la prima cifra della stringa è preceduta da un carattere di spazio non vuoto diverso da '+' o '-', la routine imposta il valore di output su zero e restituisce STATUS_SUCCESS.

Una sottostringa che contiene una o più cifre valide viene terminata da qualsiasi carattere che non sia una cifra valida. Ad esempio, se Base = 2, le cifre valide sono '0' e '1'. Se Base = 8, le cifre valide sono da '0' a '7'. Se Base = 10, le cifre valide sono da '0' a '9'. Se Base = 16, le cifre valide sono da '0' a '9', 'a' a 'f' e 'A' a 'F'.

La tabella seguente contiene esempi di valori di output risultanti da varie combinazioni di stringhe di input e valori dei parametri di base .

Una routine correlata , RtlIntegerToUnicodeString, converte un valore intero nella rappresentazione di stringa Unicode equivalente.

Requisiti

Vedi anche

RtlIntegerToUnicodeString

UNICODE_STRING