IDebugControl2::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を後続で呼び出します。

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

要件	価値
ターゲットプラットフォームの	デスクトップ
ヘッダー	dbgeng.h (Dbgeng.h を含む)