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

  • [アーティクル]

GetExtensionFunction メソッドは、拡張ライブラリから拡張関数へのポインターを返します。

構文

HRESULT GetExtensionFunction(
  [in]  ULONG64 Handle,
  [in]  PCSTR   FuncName,
  [out] FARPROC *Function
);

パラメーター

[in] Handle

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

[in] FuncName

返す拡張関数の名前を指定します。 関数の拡張機能ライブラリを検索すると、デバッガー エンジンによって名前の先頭に "EFN" が付加されます。 たとえば、 FuncName が "SampleFunction" の場合、エンジンは拡張ライブラリで "_EFN_SampleFunction" を検索します。

[out] Function

拡張関数を受け取ります。

戻り値

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

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

注釈

拡張ライブラリはホスト エンジンに読み込まれ、拡張機能関数をリモートで呼び出すことはできません。 現在のクライアントはデバッグ クライアントではなく、ホスト エンジンに属している必要があります。

拡張関数には、任意の関数プロトタイプを含めることができます。 プログラムがこの拡張関数を呼び出すには、拡張関数を正しいプロトタイプにキャストする必要があります。

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

要件

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

こちらもご覧ください

AddExtension

CallExtension

GetExtensionByPath

IDebugControl

IDebugControl2

IDebugControl3