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

另请参阅

IDebugControl7