IDebugProcess2::Attach
將工作階段偵錯管理員 (SDM) 附加至處理序。
HRESULT Attach(
IDebugEventCallback2* pCallback,
GUID* rgguidSpecificEngines,
DWORD celtSpecificEngines,
HRESULT* rghrEngineAttach
);
int Attach(
IDebugEventCallback2 pCallback,
Guid[] rgguidSpecificEngines,
uint celtSpecificEngines,
int[] rghrEngineAttach
);
參數
pCallback
[in]IDebugEventCallback2用於偵錯事件告知的物件。rgguidSpecificEngines
[in]Guid 的偵錯引擎，以用於偵錯的處理序中執行的程式陣列。 這個參數可以是 null 值。 如需詳細資訊，請參閱 「 備註 」。celtSpecificEngines
[in]偵錯引擎在rgguidSpecificEngines陣列和大小的rghrEngineAttach陣列。rghrEngineAttach
輸入 [、 輸出]偵錯引擎所傳回的 HRESULT 代碼的陣列。 此陣列的大小控制台中celtSpecificEngines參數。 每個程式碼通常是其中一個S_OK或S_ATTACH_DEFERRED。 後者表示目前的程式沒有附加 DE。
傳回值
如果成功的話，會傳回S_OK。 否則，會傳回錯誤碼。 下表顯示其他可能的值。
值 |
描述 |
|---|---|
E_ATTACH_DEBUGGER_ALREADY_ATTACHED |
指定的處理序已附加偵錯工具。 |
E_ATTACH_DEBUGGEE_PROCESS_SECURITY_VIOLATION |
附加程序期間，發生安全性違規。 |
E_ATTACH_CANNOT_ATTACH_TO_DESKTOP |
桌上型電腦的處理程序無法附加至偵錯工具。 |
備註
附加至處理序附加至偵錯引擎 (DE) 控制台中才能進行偵錯該處理序中執行的所有程式的 SDM rgguidSpecificEngines陣列。 設定rgguidSpecificEngines設為 null 的參數值，或包含GUID_NULL陣列中要附加至處理序中的所有程式。
在處理程序中發生的所有偵錯事件都傳送到指定IDebugEventCallback2物件。 這IDebugEventCallback2 SDM 會呼叫這個方法時，提供物件。