Función RtlIntegerToUnicodeString (wdm.h)

  • Artículo

La rutina RtlIntegerToUnicodeString convierte un valor entero sin signo en una cadena terminada en null de uno o varios caracteres Unicode en la base especificada.

Sintaxis

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

Parámetros

[in] Value

Especifica el valor de ULONG que se va a convertir.

[in, optional] Base

Especifica la base que se va a usar al convertir Value en una cadena. Los valores posibles son:

Valor Base
16 Hexadecimal
8 Octal
2 Binary
0 o 10 Decimal

[in, out] String

Puntero a una estructura UNICODE_STRING que recibe la representación de cadena de Value. El búfer especificado por el búfer de cadena debe ser lo suficientemente grande como para contener el resultado.

Valor devuelto

RtlIntegerToUnicodeString devuelve un valor NTSTATUS. Entre los posibles valores devueltos se incluyen:

Código devuelto Descripción
STATUS_SUCCESS
 La rutina convirtió correctamente Value en una cadena Unicode.
STATUS_BUFFER_OVERFLOW
 El valor es demasiado grande para convertir o la estructura de UNICODE_STRING es demasiado pequeña para contener el resultado.
STATUS_INVALID_PARAMETER
 El código base especificado no es válido. Los únicos valores válidos son 0, 2, 8, 10 y 16.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible a partir de Windows 2000.
Plataforma de destino Universal
Encabezado wdm.h (incluye Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe (modo kernel); Ntdll.dll (modo de usuario)
IRQL PASSIVE_LEVEL

Consulte también

RtlAppendUnicodeStringToString

RtlUnicodeStringToInteger

UNICODE_STRING