IDebugControl3::GetDebuggeeType method (dbgeng.h)

The GetDebuggeeType method describes the nature of the current target.

Syntax

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

Parameters

[out] Class

Receives the class of the current target. It will be set to one of the values in the following table.

Value Description
DEBUG_CLASS_UNINITIALIZED There is no current target.
DEBUG_CLASS_KERNEL The current target is a kernel-mode target.
DEBUG_CLASS_USER_WINDOWS The current target is a user-mode target.

[out] Qualifier

Provides more details about the type of the target. Its interpretation depends on the value of Class. When class is DEBUG_CLASS_UNINITIALIZED, Qualifier returns zero. The following values are applicable for kernel-mode targets.

Value Description
DEBUG_KERNEL_CONNECTION The current target is a live kernel being debugged in the standard way (using a COM port, 1394 bus, or named pipe).
DEBUG_KERNEL_LOCAL The current target is the local kernel.
DEBUG_KERNEL_EXDI_DRIVER The current target is a live kernel connected using eXDI drivers.
DEBUG_KERNEL_SMALL_DUMP The current target is a kernel-mode Small Memory Dump file.
DEBUG_KERNEL_DUMP The current target is a kernel-mode Kernel Memory Dump file.
DEBUG_KERNEL_FULL_DUMP The current target is a kernel-mode Complete Memory Dump file.
 

The following values are applicable for user-mode targets.

Value Description
DEBUG_USER_WINDOWS_PROCESS The current target is a user-mode process on the same computer as the debugger engine.
DEBUG_USER_WINDOWS_PROCESS_SERVER The current target is a user-mode process connected using a process server.
DEBUG_USER_WINDOWS_SMALL_DUMP The current target is a user-mode Minidump file.
DEBUG_USER_WINDOWS_DUMP The current target is a Full User-Mode Dump file.

Return value

This method may also return error values. See Return Values for more details.

Return code Description
S_OK
The method was successful.

Requirements

Requirement Value
Target Platform Desktop
Header dbgeng.h (include Dbgeng.h)