Compartir a través de


Función RtlInt64ToUnicodeString (wdm.h)

La rutina RtlInt64ToUnicodeString convierte un valor entero de 64 bits sin signo especificado en una cadena Unicode que representa el valor de una base especificada.

Sintaxis

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

Parámetros

[in] Value

Especifica el valor de ULONGLONG 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 la 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

RtlInt64ToUnicodeString devuelve un valor NTSTATUS. Entre los valores devueltos posibles 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
IRQL PASSIVE_LEVEL

Consulte también

RtlAppendUnicodeStringToString

RtlUnicodeStringToInteger

UNICODE_STRING