Função RtlIntegerToUnicodeString (wdm.h)
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 |
|---|---|
|
A rotina converteu Value com êxito em uma cadeia de caracteres Unicode. |
|
O valor é muito grande para ser convertido ou a estrutura UNICODE_STRING é muito pequena para conter 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 (modo kernel); Ntdll.dll (modo de usuário) |
| IRQL | PASSIVE_LEVEL |