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 を含む)