(dbgeng.h) IDebugClient：：AttachKernel 方法

AttachKernel 方法會將調試程式引擎連接到核心目標。

語法

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

[in] Flags

指定旗標，控制調試程式如何附加至核心目標。可能的值包括：

值	Description
DEBUG_ATTACH_KERNEL_CONNECTION	附加至目標計算機上的核心。
DEBUG_ATTACH_EXDI_DRIVER	使用 eXDI 驅動程式附加至核心。

[in, optional] ConnectOptions

指定與執行核心目標之計算機通訊的連線設定。 ConnectOptions 的解譯取決於 Flags 的值。

ConnectOptions 會解譯為與 WinDbg 和 KD 命令行上 -k 參數後面的選項相同。環境變數會以影響 -k 參數的相同方式影響 ConnectOptions。

本檔未說明 eXDI 驅動程式。如果您有硬體探查或硬體模擬器的 eXDI 介面，請連絡 Microsoft 以取得偵錯資訊。

這個方法也可能傳回錯誤值。如需詳細資訊，請參閱傳回值。

傳回碼	描述
S_OK	此方法成功。

注意在呼叫 WaitForEvent 方法之前，引擎不會完全附加至核心。只有在核心產生事件之後，才會在調試程式會話中變成可用的事件，例如初始斷點。

如需連線到即時核心模式目標的詳細資訊，請參閱即時 Kernel-Mode 目標。

需求	值
目標平台	桌面
標頭	dbgeng.h (包含 Dbgeng.h)