共用方式為

DebugCreateEx 函式 (dbgeng.h)

  • 發行項

DebugCreateEx 函式會建立新的客戶端物件，並傳回它的介面指標。

語法

HRESULT DebugCreateEx(
  [in]  REFIID InterfaceId,
  [in]  DWORD  DbgEngOptions,
  [out] PVOID  *Interface
);

參數

[in] InterfaceId

指定所需調試程式引擎用戶端介面的介面標識碼 (IID) 。 這是 介面中將傳回的介面類型。 如需介面標識碼的相關信息，請參閱 使用客戶端物件。

[in] DbgEngOptions

提供調試程式選項旗標。

[out] Interface

接收新客戶端的介面指標。 這個介面的類型是由 InterfaceId 所指定。

傳回值

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

傳回碼 描述
S_OK
 函式成功。
E_NOINTERFACE
用戶端物件不會實作指定的介面。

備註

傳遞至 DebugCreateEx 的參數與傳遞至 IUnknown：：QueryInterface 的參數相同，而且會以相同方式加以處理。

如同 IUnknown：：QueryInterface，當不再需要傳回的介面時，應該呼叫其 IUnknown：：Release 方法。

您不需要呼叫 CoInitialize、 CoInitializeEx 或 OleInitialize ，即可使用此函式及其取得的介面。

無法藉由呼叫 CoCreateInstance、CoCreateInstanceEx 或 CoGetClassObject 來取得除錯程式引擎用戶端介面。 使用 DebugCreate、DebugCreateEx、DebugConnect 或 DebugConnectWide 來建立這類介面，或在另一個調試程式引擎用戶端介面上呼叫 IUnknown：：QueryInterface。

規格需求

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

另請參閱

用戶端函式

客戶端物件