Macro RtlIntPtrToUnicodeString (wdm.h)
La routine RtlIntPtrToUnicodeString converte un valore ULONG_PTR specificato in una stringa Unicode che rappresenta il valore in una base specificata.
Sintassi
void RtlIntPtrToUnicodeString(
[in] Value,
[in, optional] Base,
[in, out] String
);
Parametri
[in] Value
Specifica il valore ULONG_PTR da convertire.
[in, optional] Base
Specifica la base da usare durante la conversione di Valore 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 stringa di Value. Il buffer specificato dal buffer di String deve essere sufficiente per contenere il risultato.
Valore restituito
nessuno
Osservazioni
RtlIntPtrToUnicodeString restituisce un valore NTSTATUS. I valori restituiti possibili includono :
| Codice restituito | Descrizione |
|---|---|
| STATUS_SUCCESS | La routine convertita correttamente valore in una stringa Unicode. |
| STATUS_BUFFER_OVERFLOW | Il valore è troppo grande da convertire o la struttura UNICODE_STRING è troppo piccola per contenere il risultato. |
| STATUS_INVALID_PARAMETER | La code base 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 | Desktop |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |