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

  • [アーティクル]

コンテナーがオブジェクトをサイトのインターフェイスへのポインターを渡すことができます。

構文

HRESULT SetSite(
  [in] IUnknown *pUnkSite
);

パラメーター

[in] pUnkSite

このオブジェクトを管理しているサイトの IUnknown インターフェイス ポインターへのポインター。 NULL の場合、オブジェクトは既存のサイトで Release を呼び出す必要があります。その時点で、オブジェクトはそのサイトを認識しなくなります。

戻り値

このメソッドは、成功したS_OKを返します。

注釈

オブジェクトはこのポインターを保持し、 IUnknown::AddRef を呼び出す必要があります。 オブジェクトに既にサイトがある場合は、その既存のサイトの IUnknown::Release を呼び出し、新しいサイト ポインターを保存して、新しいサイトの IUnknown::AddRef を呼び出す必要があります。

E_NOTIMPLは許可されません。 SetSite メソッドを実装しないと、IObjectWithSite インターフェイスは不要です。

要件

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

こちらもご覧ください

IObjectWithSite