DebugCreateEx 函式 (dbgeng.h)
DebugCreateEx 函式會 建立新的 客戶端物件,並傳回它的介面指標。
語法
HRESULT DebugCreateEx(
[in] REFIID InterfaceId,
[in] DWORD DbgEngOptions,
[out] PVOID *Interface
);
參數
[in] InterfaceId
指定所需調試程式引擎用戶端介面的介面識別碼 (IID)。 這是將在 Interface中傳回的介面類型。 如需介面識別碼的相關信息,請參閱使用客戶端物件 。
[in] DbgEngOptions
提供調試程式選項旗標。
[out] Interface
接收新客戶端的介面指標。 這個介面的類型是由 InterfaceId所指定。
傳回值
這個方法也可能傳回其他錯誤值。 如需詳細資訊,請參閱 傳回值。
傳回碼 | 描述 |
---|---|
|
函式成功。 |
|
用戶端物件不會實作指定的介面。 |
言論
傳遞給 DebugCreateEx 的參數與傳遞至 IUnknown::QueryInterface的參數相同,而且會以相同方式處理它們。
如同 IUnknown::QueryInterface,當不再需要傳回的介面時,應該呼叫其 IUnknown::Release 方法。
您不需要呼叫 CoInitialize、CoInitializeEx,或 OleInitialize 來使用此函式和其取得的介面。
無法藉由呼叫 CoCreateInstance、CoCreateInstanceEx或 CoGetClassObject來取得調試程式引擎用戶端介面。 使用 DebugCreate、DebugCreateEx、DebugConnect或 DebugConnectWide,在另一個調試程式引擎用戶端介面上呼叫 IUnknown::QueryInterface。
要求
要求 | 價值 |
---|---|
目標平臺 | 桌面 |
標頭 | dbgeng.h (include Dbgeng.h) |