Функция WindowsInspectString2 (winstring.h)

Предоставляет возможность отладчикам отображать значение HSTRING среды выполнения Windows в другом адресном пространстве, удаленно или из дампа.

Синтаксис

HRESULT WindowsInspectString2(
  UINT64                     targetHString,
  USHORT                     machine,
  PINSPECT_HSTRING_CALLBACK2 callback,
  void                       *context,
  UINT32                     *length,
  UINT64                     *targetStringAddress
);

Параметры

targetHString

[in]

HSTRING для проверки.

machine

Формат целевого адресного пространства. Допустимые значения: IMAGE_FILE_MACHINE_AMD64 для Win64, IMAGE_FILE_MACHINE_I386 для Win32 или IMAGE_FILE_MACHINE_ARM для 32-разрядной версии ARM.

callback

[in]

Функция обратного вызова для чтения строкового буфера из целевого адресного пространства. Эта функция вызывается до вычисления параметров length и targetStringAddress функцией WindowsInspectString2 .

context

[in, необязательный]

Пользовательские данные контекста, передаваемые обратному вызову.

length

[out]

Длина строки в целевом адресном пространстве, если вызов обратного вызова выполнен успешно; в противном случае — значение 0.

targetStringAddress

[out]

Целевой адрес необработанного PCWSTR, если вызов обратного вызова выполнен успешно; в противном случае значение NULL.

Возвращаемое значение

Эта функция может возвращать одно из этих значений.

Код возврата	Description
E_INVALIDARG	Значение компьютера не IMAGE_FILE_MACHINE_AMD64, IMAGE_FILE_MACHINE_I386 или IMAGE_FILE_MACHINE_ARM или targetHString не является правильно сформированным HSTRING.

Замечания

Функция WindowsInspectString передает входные и выходные указатели в качестве собственных значений размера указателя. Если текущая платформа — Win32, эта функция возвращает ошибку для процессов, которые являются Win64.

WindowsInspectString2 позволяет выполнять отладку между архитектурой, позволяя использовать до 64-разрядных значений при вызове из приложений Win32 и Win64.

Требования

Требование	Ценность
Минимальный поддерживаемый клиент	Windows 8
минимальный поддерживаемый сервер	Windows Server 2012
целевая платформа	Windows
Header	winstring.h
Library	RuntimeObject.lib
DLL	ComBase.dll

См. также

HSTRING

PINSPECT_HSTRING_CALLBACK

WindowsCreateString

WindowsInspectString