Función WindowsInspectString2 (winstring.h)
Proporciona una manera de que los depuradores muestren el valor de un Windows Runtime HSTRING en otro espacio de direcciones, de forma remota o desde un volcado de memoria.
Sintaxis
HRESULT WindowsInspectString2(
UINT64 targetHString,
USHORT machine,
PINSPECT_HSTRING_CALLBACK2 callback,
void *context,
UINT32 *length,
UINT64 *targetStringAddress
);
Parámetros
targetHString
[in]
HSTRING que se va a inspeccionar.
machine
Formato del espacio de direcciones de destino. Los valores válidos son IMAGE_FILE_MACHINE_AMD64 para Win64, IMAGE_FILE_MACHINE_I386 para Win32 o IMAGE_FILE_MACHINE_ARM para ARM de 32 bits.
callback
[in]
Función de devolución de llamada para leer el búfer de cadena del espacio de direcciones de destino. Se llama a esta función antes de que los parámetros length y targetStringAddress se calculen mediante la función WindowsInspectString2 .
context
[in, opcional]
Datos de contexto personalizados pasados a la devolución de llamada.
length
[out]
Longitud de la cadena en el espacio de direcciones de destino, si la llamada a la devolución de llamada es correcta; de lo contrario, 0.
targetStringAddress
[out]
La dirección de destino del PCWSTR sin procesar, si la llamada a la devolución de llamada es correcta; en caso contrario, NULL.
Valor devuelto
Esta función puede devolver uno de estos valores.
Código devuelto | Descripción |
---|---|
|
|
Comentarios
La función WindowsInspectString pasa los punteros de entrada y salida como valores nativos de tamaño de puntero. Si la plataforma actual es Win32, esa función devuelve un error para los procesos que son Win64.
WindowsInspectString2 habilita la depuración entre arquitecturas al permitir hasta 64 bits de valores cuando se llama desde aplicaciones Win32 y Win64.
Requisitos
Cliente mínimo compatible | Windows 8 |
Servidor mínimo compatible | Windows Server 2012 |
Plataforma de destino | Windows |
Encabezado | winstring.h |
Library | RuntimeObject.lib |
Archivo DLL | ComBase.dll |