DebugConnectWide 関数 (dbgeng.h)

DebugConnect 関数と DebugConnectWide 関数は、新しいクライアントオブジェクトを作成し、それに対するインターフェイスポインターを返します。クライアントオブジェクトはリモートホストに接続されます。

構文

HRESULT DebugConnectWide(
  [in]  PCWSTR RemoteOptions,
  [in]  REFIID InterfaceId,
  [out] PVOID  *Interface
);

[in] RemoteOptions

デバッガーエンジンがリモートホストに接続する方法を指定します。これらは、コマンドラインの -remote オプションに渡されるのと同じオプションです。この文字列の構文の詳細については、「デバッグクライアントのアクティブ化」を参照してください。

[in] InterfaceId

目的のデバッガーエンジンクライアントインターフェイスのインターフェイス識別子 (IID) を指定します。これは、Interface で返されるインターフェイスの型です。インターフェイス識別子の詳細については、「クライアントオブジェクトの使用」を参照してください。

[out] Interface

新しいクライアントのインターフェイスポインターを受け取ります。このインターフェイスの型は InterfaceId で指定されます。

このメソッドは、エラー値を返す場合もあります。詳細については、「戻り値」を参照してください。

リターンコード	説明
S_OK	メソッドは正常に実行されました。

IUnknown::QueryInterface と同様に、返されたインターフェイスが不要になったら、その IUnknown::Release メソッドを呼び出す必要があります。

この関数とによって取得されたインターフェイスを使用するために、 CoInitialize、 CoInitializeEx、 または OleInitialize を呼び出す必要はありません。

要件	値
対象プラットフォーム	デスクトップ
Header	dbgeng.h (Dbgeng.h を含む)