Функция WindowsInspectString2 (winstring.h)
Предоставляет отладчикам способ отображения значения среда выполнения Windows HSTRING в другом адресном пространстве, удаленно или из дампа.
Синтаксис
HRESULT WindowsInspectString2(
UINT64 targetHString,
USHORT machine,
PINSPECT_HSTRING_CALLBACK2 callback,
void *context,
UINT32 *length,
UINT64 *targetStringAddress
);
Параметры
targetHString
[in]
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.
Требования
| Минимальная версия клиента | Windows 8 |
| Минимальная версия сервера | Windows Server 2012 |
| Целевая платформа | Windows |
| Header | winstring.h |
| Библиотека | RuntimeObject.lib |
| DLL | ComBase.dll |