Метод IDebugControl::GetDebuggeeType (dbgeng.h)

Статья
08/07/2023

Метод GetDebuggeeType описывает природу текущего целевого объекта.

Синтаксис

HRESULT GetDebuggeeType(
  [out] PULONG Class,
  [out] PULONG Qualifier
);

Параметры

[out] Class

Получает класс текущего целевого объекта. Ему будет присвоено одно из значений в следующей таблице.

Значение	Описание
DEBUG_CLASS_UNINITIALIZED	Текущего целевого объекта нет.
DEBUG_CLASS_KERNEL	Текущий целевой объект является целевым объектом в режиме ядра.
DEBUG_CLASS_USER_WINDOWS	Текущий целевой объект является целевым объектом в пользовательском режиме.

[out] Qualifier

Дополнительные сведения о типе целевого объекта. Его интерпретация зависит от значения Class. Если класс DEBUG_CLASS_UNINITIALIZED, квалификатор возвращает ноль. Следующие значения применимы к целевым объектам в режиме ядра.

Значение	Описание
DEBUG_KERNEL_CONNECTION	Текущий целевой объект — это динамическое ядро, отлаживаемое стандартным способом (с использованием COM-порта, шины 1394 или именованного канала).
DEBUG_KERNEL_LOCAL	Текущим целевым объектом является локальное ядро.
DEBUG_KERNEL_EXDI_DRIVER	Текущий целевой объект — это динамическое ядро, подключенное с помощью драйверов eXDI.
DEBUG_KERNEL_SMALL_DUMP	Текущий целевой объект — файл дампа небольшой памяти в режиме ядра.
DEBUG_KERNEL_DUMP	Текущим целевым объектом является файл дампа памяти ядра в режиме ядра.
DEBUG_KERNEL_FULL_DUMP	Текущим целевым объектом является файл полного дампа памяти в режиме ядра.

Следующие значения применимы к целевым объектам в пользовательском режиме.

Значение	Описание
DEBUG_USER_WINDOWS_PROCESS	Текущий целевой объект — это процесс в пользовательском режиме на том же компьютере, что и обработчик отладчика.
DEBUG_USER_WINDOWS_PROCESS_SERVER	Текущий целевой объект — это процесс в пользовательском режиме, подключенный с помощью сервера обработки.
DEBUG_USER_WINDOWS_SMALL_DUMP	Текущий целевой объект — это файл Minidump в пользовательском режиме.
DEBUG_USER_WINDOWS_DUMP	Текущий целевой объект — файл дампа полного User-Mode.

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

Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в разделе Возвращаемые значения .

Код возврата	Описание
S_OK	Метод выполнен успешно.

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	dbgeng.h (включая Dbgeng.h)

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