DebugCreate 函式 (dbgeng.h)

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

語法

HRESULT DebugCreate(
  [in]  REFIID InterfaceId,
  [out] PVOID  *Interface
);

參數

[in] InterfaceId

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

[out] Interface

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

傳回值

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

備註

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

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

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

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

規格需求

另請參閱

客戶端物件