IDebugClient3：：AttachKernel 方法 (dbgeng.h)

AttachKernel 方法将调试器引擎连接到内核目标。

语法

HRESULT AttachKernel(
  [in]           ULONG Flags,
  [in, optional] PCSTR ConnectOptions
);

[in] Flags

指定控制调试器如何附加到内核目标的标志。可能的值包括：

值	说明
DEBUG_ATTACH_KERNEL_CONNECTION	附加到目标计算机上的内核。
DEBUG_ATTACH_EXDI_DRIVER	使用 eXDI 驱动程序附加到内核。

[in, optional] ConnectOptions

指定用于与运行内核目标的计算机通信的连接设置。 ConnectOptions 的解释取决于 Flags 的值。

ConnectOptions 的解释方式与 WinDbg 和 KD 命令行上 -k 开关后面的选项相同。环境变量影响 ConnectOptions 的方式与它们影响 -k 开关的方式相同。

本文档未介绍 eXDI 驱动程序。如果你有硬件探测或硬件模拟器的 eXDI 接口，请联系 Microsoft 以获取调试信息。

此方法也可能返回错误值。有关更多详细信息，请参阅返回值。

返回代码	说明
S_OK	方法成功。

注意在调用 WaitForEvent 方法之前，引擎不会完全附加到内核。只有在内核生成事件（例如，初始断点）后，它才会在调试器会话中可用。

有关连接到实时内核模式目标的详细信息，请参阅实时 Kernel-Mode 目标。

要求	值
目标平台	桌面
标头	dbgeng.h (包括 Dbgeng.h)