Macro RtlIntPtrToUnicodeString (wdm.h)
La rutina RtlIntPtrToUnicodeString convierte un valor de ULONG_PTR especificado en una cadena Unicode que representa el valor de una base especificada.
Sintaxis
void RtlIntPtrToUnicodeString(
[in] Value,
[in, optional] Base,
[in, out] String
);
Parámetros
[in] Value
Especifica el valor de ULONG_PTR 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
None
Observaciones
RtlIntPtrToUnicodeString 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 | Escritorio |
| Encabezado | wdm.h (incluye Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |