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

Статья
03/04/2024

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

Синтаксис

HRESULT WindowsInspectString(
  UINT_PTR                  targetHString,
  USHORT                    machine,
  PINSPECT_HSTRING_CALLBACK callback,
  void                      *context,
  UINT32                    *length,
  UINT_PTR                  *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 функцией WindowsInspectString .

context

[in, optional]

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

length

[выходной]

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

targetStringAddress

[выходной]

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

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

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

Код возврата	Описание
E_INVALIDARG	IMAGE_FILE_MACHINE_AMD64 для компьютера, но текущая платформа не является Win64, или компьютер не IMAGE_FILE_MACHINE_AMD64, IMAGE_FILE_MACHINE_I386 или IMAGE_FILE_MACHINE_ARM; targetHString не имеет правильного формата HSTRING.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8
Минимальная версия сервера	Windows Server 2012
Целевая платформа	Windows
Header	winstring.h
Библиотека	RuntimeObject.lib
DLL	ComBase.dll

См. также раздел

HSTRING

PINSPECT_HSTRING_CALLBACK

WindowsCreateString

Поделиться через