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

[アーティクル]
02/23/2024

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 を含む)

こちらもご覧ください

GetExtensionByPath