Função RtlInt64ToUnicodeString (wdm.h)
A rotina RtlInt64ToUnicodeString converte um valor inteiro de 64 bits não assinado especificado em uma cadeia de caracteres Unicode que representa o valor em uma base especificada.
Sintaxe
NTSYSAPI NTSTATUS RtlInt64ToUnicodeString(
[in] ULONGLONG Value,
[in, optional] ULONG Base,
[in, out] PUNICODE_STRING String
);
Parâmetros
[in] Value
Especifica o valor ULONGLONG a ser convertido.
[in, optional] Base
Especifica a base a ser usada ao converter Value em uma cadeia de caracteres. Os valores possíveis são:
| Valor | Base |
|---|---|
| 16 | Hexadecimal |
| 8 | Octal |
| 2 | Binário |
| 0 ou 10 | Decimal |
[in, out] String
Ponteiro para a estrutura UNICODE_STRING que recebe a representação de cadeia de caracteres de Value. O buffer especificado pelo Buffer de Cadeia de Caracteres deve ser grande o suficiente para manter o resultado.
Retornar valor
RtlInt64ToUnicodeString retorna um valor NTSTATUS. Os possíveis valores retornados incluem :
| Código de retorno | Descrição |
|---|---|
|
A rotina converteu Value com êxito em uma cadeia de caracteres Unicode. |
|
O valor é muito grande para ser convertido ou a estrutura de UNICODE_STRING é muito pequena para manter o resultado. |
|
A base de código especificada não é válida. Os únicos valores válidos são 0, 2, 8, 10 e 16. |
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível a partir do Windows 2000. |
| Plataforma de Destino | Universal |
| Cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h) |
| Biblioteca | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |