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 |