Función WindowsInspectString2 (winstring.h)

Proporciona una manera de que los depuradores muestren el valor de un HSTRING de Windows Runtime en otro espacio de direcciones, de forma remota o desde un volcado de memoria.

Syntax

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 cadenas del espacio de direcciones de destino. Se llama a esta función antes de que la función WindowsInspectString2 calcule los parámetros length y targetStringAddress.

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]

Dirección de destino del PCWSTR sin formato, si la llamada a la devolución de llamada es correcta; de lo contrario, NULL.

Valor devuelto

Esta función puede devolver uno de estos valores.

Observaciones

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 valores de 64 bits cuando se llama desde aplicaciones Win32 y Win64.

Requisitos

Consulte también

HSTRING

PINSPECT_HSTRING_CALLBACK

WindowsCreateString

WindowsInspectString