Função RtlInt64ToUnicodeString (wdm.h)

  • Artigo

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
STATUS_SUCCESS
 A rotina converteu Value com êxito em uma cadeia de caracteres Unicode.
STATUS_BUFFER_OVERFLOW
 O valor é muito grande para ser convertido ou a estrutura de UNICODE_STRING é muito pequena para manter o resultado.
STATUS_INVALID_PARAMETER
 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

Confira também

RtlAppendUnicodeStringToString

RtlUnicodeStringToInteger

UNICODE_STRING