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