Метод IObjectWithSite::GetSite (ocidl.h)

  • Статья

Извлекает последний сайт, переданный с помощью SetSite.

Синтаксис

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

Параметры

[in] riid

Идентификатор IID указателя интерфейса, который должен возвращаться в ppvSite.

[out] ppvSite

Адрес переменной указателя, которая получает указатель интерфейса, запрошенный в riid. После успешного возврата *ppvSite содержит запрошенный указатель интерфейса на сайт, который последний раз видел в SetSite. Конкретный возвращаемый интерфейс зависит от аргумента riid . По сути, эти два аргумента действуют идентично аргументам в QueryInterface. Если соответствующий указатель интерфейса доступен, объект должен вызвать Метод AddRef для этого указателя перед успешной возвратом. Если сайт недоступен или запрошенный интерфейс не поддерживается, этот метод должен *ppvSite иметь значение NULL и возвращать код сбоя.

Возвращаемое значение

Этот метод возвращает значение S_OK при успешном завершении. Другие возможные возвращаемые значения включают следующее.

Код возврата Описание
E_FAIL
 Сайт отсутствует. В этом случае *ppvSite содержит значение NULL при возврате.
E_NOINTERFACE
 Существует сайт, но он не поддерживает интерфейс, запрашиваемый riid.

Комментарии

E_NOTIMPL запрещено. Любой объект, реализуя этот интерфейс, должен иметь возможность возвращать последний сайт, видимый в IObjectWithSite::SetSite.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header ocidl.h

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

IObjectWithSite