Função RtlIntegerToUnicodeString (wdm.h)

  • Artigo

A rotina RtlIntegerToUnicodeString converte um valor inteiro sem sinal em uma cadeia de caracteres terminada em nulo de um ou mais caracteres Unicode na base especificada.

Sintaxe

NTSYSAPI NTSTATUS RtlIntegerToUnicodeString(
  [in]           ULONG           Value,
  [in, optional] ULONG           Base,
  [in, out]      PUNICODE_STRING String
);

Parâmetros

[in] Value

Especifica o valor ULONG 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 uma 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

RtlIntegerToUnicodeString 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 UNICODE_STRING é muito pequena para conter 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 (modo kernel); Ntdll.dll (modo de usuário)
IRQL PASSIVE_LEVEL

Confira também

RtlAppendUnicodeStringToString

RtlUnicodeStringToInteger

UNICODE_STRING