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

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

構文

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

[in] Handle

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

[in] FuncName

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

[out] Function

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

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

リターンコード	形容
S_OK	メソッドが成功しました。

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

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

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

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