Función WindowsInspectString (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 WindowsInspectString(
  UINT_PTR                  targetHString,
  USHORT                    machine,
  PINSPECT_HSTRING_CALLBACK callback,
  void                      *context,
  UINT32                    *length,
  UINT_PTR                  *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 WindowsInspectString .

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	IMAGE_FILE_MACHINE_AMD64 se especificó para la máquina, pero la plataforma actual no es Win64 o 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.

Requisitos

Requisito	Value
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