DebugCreate 関数 (dbgeng.h)

DebugCreate 関数は、新しいクライアント オブジェクトを作成し、それに対するインターフェイス ポインターを返します。

構文

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

パラメーター

[in] InterfaceId

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

[out] Interface

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

戻り値

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

リターン コード	説明
S_OK	関数は成功しました。
E_NOINTERFACE	クライアント オブジェクトは、指定されたインターフェイスを実装していません。

注釈

DebugCreate に渡されるパラメーターは、IUnknown::QueryInterface に渡されるものと同じであり、同じように扱われます。

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

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

デバッガー エンジンのクライアント インターフェイスは、 CoCreateInstance、 CoCreateInstanceEx、または CoGetClassObject を呼び出すことによって取得できません。 DebugCreate、DebugCreateEx、DebugConnect、または DebugConnectWide を使用してこのようなインターフェイスを作成するか、別のデバッガー エンジン クライアント インターフェイスで IUnknown::QueryInterface を呼び出します。

要件

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

こちらもご覧ください

クライアント オブジェクト