IDebugControl::CallExtension メソッド (dbgeng.h)

CallExtension メソッドはデバッガー拡張機能を呼び出します。

構文

HRESULT CallExtension(
  [in]           ULONG64 Handle,
  [in]           PCSTR   Function,
  [in, optional] PCSTR   Arguments
);

[in] Handle

呼び出す拡張機能を含む拡張ライブラリのハンドルを指定します。 Handle が 0 の場合、エンジンは拡張機能を検索する拡張ライブラリチェーンをウォークします。

[in] Function

呼び出す拡張機能の名前を指定します。

[in, optional] Arguments

拡張機能に渡す引数を指定します。引数は、拡張機能が拡張コマンドとして呼び出されたときに渡された引数を解析するのと同様に、拡張機能によって解析される文字列です。

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

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

Handle が 0 の場合、エンジンは拡張機能を含むライブラリが見つかるまで各拡張ライブラリを検索します。その後、拡張機能が呼び出されます。拡張機能から DEBUG_EXTENSION_CONTINUE_SEARCHが返された場合、検索は続行されます。

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

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