Función RtlIntegerToUnicodeString (wdm.h)
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 |
|---|---|
|
La rutina convirtió correctamente Value en una cadena Unicode. |
|
El valor es demasiado grande para convertir o la estructura de UNICODE_STRING es demasiado pequeña para contener el resultado. |
|
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 |