Поделиться через

Метод IOleControlSite::GetExtendedControl (ocidl.h)

  • Статья

Извлекает указатель IDispatch на расширенный элемент управления, который контейнер использует для упаковки реального элемента управления.

Синтаксис

HRESULT GetExtendedControl(
  [out] IDispatch **ppDisp
);

Параметры

[out] ppDisp

Указатель на переменную указателя IDispatch , которая получает указатель интерфейса на расширенный элемент управления. При возникновении ошибки реализация должна присвоить *ppDisp значение NULL. При успешном выполнении вызывающий объект отвечает за вызов Release , если *ppDisp больше не требуется.

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

Этот метод может возвращать стандартные возвращаемые значения E_OUTOFMEMORY и E_UNEXPECTED, а также следующие значения.

Код возврата Описание
S_OK
 Метод завершился успешно.
E_NOTIMPL
 Контейнер не реализует расширенные элементы управления.
E_POINTER
 Недопустимый адрес в ppDisp или *ppDisp . Например, он может иметь значение NULL.

Комментарии

Этот метод предоставляет реальному элементу управления доступ к любым свойствам и методам, которые контейнер поддерживает в расширенном элементе управления. В противном случае эти свойства и методы были бы недоступны для элемента управления .

Примечания к вызывающим абонентам

Возвращаемый указатель отвечает за вызывающий объект, который должен освободить его, когда он больше не нужен.

Требования

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

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

IOleControlSite