Macro RtlIntPtrToUnicodeString (wdm.h)

  • Artigo

A rotina RtlIntPtrToUnicodeString converte um valor de ULONG_PTR especificado em uma cadeia de caracteres Unicode que representa o valor em uma base especificada.

Sintaxe

void RtlIntPtrToUnicodeString(
  [in]            Value,
  [in, optional]  Base,
  [in, out]       String
);

Parâmetros

[in] Value

Especifica o valor ULONG_PTR 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

Nenhum

Comentários

RtlIntPtrToUnicodeString 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 Área de Trabalho
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

RtlIntegerToUnicodeString

RtlUnicodeStringToInteger

UNICODE_STRING