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

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

Синтаксис

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, optional]

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

length

[выходной]

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

targetStringAddress

[выходной]

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

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

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

Комментарии

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

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

Требования

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

HSTRING

PINSPECT_HSTRING_CALLBACK

WindowsCreateString

WindowsInspectString