DebugConnect 函式 (dbgeng.h)

  • 發行項

DebugConnect 和 DebugConnectWide 函式會建立新的客戶端物件，並傳回它的介面指標。 用戶端物件會連線到遠端主機。

語法

HRESULT DebugConnect(
  [in]  PCSTR  RemoteOptions,
  [in]  REFIID InterfaceId,
  [out] PVOID  *Interface
);

參數

[in] RemoteOptions

指定調試程式引擎如何連線到遠端主機。 這些是傳遞至命令行上 -remote 選項的相同選項。 如需此字串語法的詳細資訊，請參閱 啟用偵錯用戶端。

[in] InterfaceId

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

[out] Interface

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

傳回值

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

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

備註

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

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

規格需求

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

另請參閱

客戶端物件

進程伺服器和智慧型手機用戶端