IObjectWithSite::GetSite メソッド (ocidl.h)

  • [アーティクル]

SetSite を使用して渡された最新のサイトを取得します。

構文

HRESULT GetSite(
  [in]  REFIID riid,
  [out] void   **ppvSite
);

パラメーター

[in] riid

ppvSite で返されるインターフェイス ポインターの IID。

[out] ppvSite

riid で要求されたインターフェイス ポインターを受け取るポインター変数のアドレス。 正常に戻ると、*ppvSite には 、SetSite で最後に表示されたサイトへの要求されたインターフェイス ポインターが含まれます。 返される特定のインターフェイスは 、riid 引数によって異なります。 本質的に、2 つの引数は QueryInterface の引数と同じように動作します。 適切なインターフェイス ポインターが使用可能な場合、オブジェクトは正常に返される前に、そのポインターで AddRef を呼び出す必要があります。 サイトが使用できない場合、または要求されたインターフェイスがサポートされていない場合、このメソッドは *ppvSite を NULL にしてエラー コードを返す必要があります。

戻り値

このメソッドは、成功したS_OKを返します。 その他の可能な戻り値は次のとおりです。

リターン コード 説明
E_FAIL
 サイトはありません。この場合、戻り値に *ppvSite に NULL が含まれます。
E_NOINTERFACE
 サイトがありますが、 riid によって要求されたインターフェイスはサポートされていません。

注釈

E_NOTIMPLは許可されていません。 このインターフェイスを実装するオブジェクトは、 IObjectWithSite::SetSite に表示される最後のサイトを返すことができる必要があります。

要件

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

こちらもご覧ください

IObjectWithSite