Compartir a través de


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
E_INVALIDARG
  • El valor de la máquina no es IMAGE_FILE_MACHINE_AMD64, IMAGE_FILE_MACHINE_I386 ni IMAGE_FILE_MACHINE_ARM ni
  • targetHString no es un HSTRING formado correctamente.

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

Consulte también

HSTRING

PINSPECT_HSTRING_CALLBACK

WindowsCreateString

WindowsInspectString