Метод 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
Header ocidl.h

См. также раздел

IObjectWithSite