IOleControlSite::GetExtendedControl メソッド (ocidl.h)

  • [アーティクル]

コンテナーが実際のコントロールをラップするために使用する拡張コントロールへの IDispatch ポインターを取得します。

構文

HRESULT GetExtendedControl(
  [out] IDispatch **ppDisp
);

パラメーター

[out] ppDisp

拡張コントロールへのインターフェイス ポインターを受け取る IDispatch ポインター変数へのポインター。 エラーが発生した場合、実装では *ppDisp を NULL に設定する必要があります。 成功した場合、*ppDisp が不要になった場合、呼び出し元は Release を呼び出す必要があります。

戻り値

このメソッドは、E_OUTOFMEMORYおよびE_UNEXPECTED標準の戻り値と、次の値を返すことができます。

リターン コード 説明
S_OK
 メソッドは正常に完了しました。
E_NOTIMPL
 コンテナーには拡張コントロールは実装されません。
E_POINTER
 ppDisp または *ppDisp のアドレスが無効です。 たとえば、 NULL である可能性があります。

注釈

このメソッドは、コンテナーが拡張コントロールで管理するプロパティとメソッドに対する実際の制御アクセスを提供します。 これらのプロパティとメソッドは、それ以外の場合はコントロールにアクセスできません。

呼び出し元へのメモ

返されるポインターは呼び出し元の責任であり、不要になったときに解放する必要があります。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー ocidl.h

こちらもご覧ください

IOleControlSite