IDebugControl3::AddExtension メソッド (dbgeng.h)

AddExtension メソッドは、デバッガーエンジンに拡張ライブラリを読み込みます。

構文

HRESULT AddExtension(
  [in]  PCSTR    Path,
  [in]  ULONG    Flags,
  [out] PULONG64 Handle
);

[in] Path

読み込む拡張ライブラリの完全修飾パスとファイル名を指定します。

[in] Flags

0 に設定します。

[out] Handle

読み込まれた拡張ライブラリのハンドルを受け取ります。

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

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

拡張ライブラリが既に読み込まれている場合は、既に読み込まれているライブラリへのハンドルが返されます。拡張ライブラリは再び読み込まれません。

拡張ライブラリはホストエンジンに読み込まれ、 Path にはデバッガーエンジンのこのインスタンスのパスとファイル名が含まれています。

AddExtension では、拡張機能 DLL の読み込みと初期化のプロセスは完了しません。拡張機能を使用できるようにするには、 GetExtensionFunction の後続の呼び出しを行います。

拡張ライブラリの使用の詳細については、「拡張機能と拡張機能の呼び出し」を参照してください。

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