IDebugControl7::GetDebuggeeType2 方法 (dbgeng.h)
GetDebuggeeType2 方法描述当前目标的性质。
语法
HRESULT GetDebuggeeType2(
[in] ULONG Flags,
[out] PULONG Class,
[out] PULONG Qualifier
);
参数
[in] Flags
采用单个标志(DEBUG_EXEC_FLAGS_NONBLOCK),该标志指示函数 GetDebuggeeType2 在查找调试对象类型之前是否应拥有引擎关键部分对象 (g_EngineLock) 。
如果标志存在,则该函数将尝试拥有关键部分。 如果失败,它会继续,而不会阻止调用方线程。
如果未传入标志,则函数将等待引擎关键部分变为可用,然后再继续。
[out] Class
接收当前目标的 类。 它将设置为下表中的值之一。
值 | 说明 |
---|---|
DEBUG_CLASS_UNINITIALIZED | 没有当前目标。 |
DEBUG_CLASS_KERNEL | 当前目标是内核模式目标。 |
DEBUG_CLASS_USER_WINDOWS | 当前目标是用户模式目标。 |
[out] Qualifier
提供有关目标类型的更多详细信息。 其解释取决于 类的值。 当类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 | 当前目标是用户模式小型转储文件。 |
DEBUG_USER_WINDOWS_DUMP | 当前目标是完整 User-Mode 转储文件。 |
返回值
此方法不返回值。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | dbgeng.h |