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 |
---|---|
|
The method was successful. |
Requirements
Requirement | Value |
---|---|
Target Platform | Desktop |
Header | dbgeng.h (include Dbgeng.h) |