Метод IOleObject::SetHostNames (oleidl.h)

Предоставляет объекту имена его контейнерного приложения и составного документа, в который он внедрен.

Синтаксис

HRESULT SetHostNames(
  [in] LPCOLESTR szContainerApp,
  [in] LPCOLESTR szContainerObj
);

Параметры

[in] szContainerApp

Указатель на имя приложения-контейнера, в котором выполняется объект.

[in] szContainerObj

Указатель на имя составного документа, содержащего объект. Если вы не хотите отображать имя составного документа, можно задать для этого параметра значение NULL.

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

Этот метод возвращает значение S_OK при успешном завершении.

Комментарии

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

Вызывайте IOleObject::SetHostNames только для внедренных объектов, так как для связанных объектов источник ссылки предоставляет собственные отдельные сведения о окне редактирования и строке заголовка.

Примечания для разработчиков

Приложение объекта IOleObject::SetHostNames должно включать любые изменения в пользовательском интерфейсе, которые могут быть подходящими для внедренного состояния объекта. Такие изменения обычно включают добавление и удаление команд меню, а также изменение текста, отображаемого в заголовке окна редактирования.

Полный заголовок окна для внедренного объекта в контейнерном приложении SDI или приложении MDI с развернутым дочерним окном должен выглядеть следующим образом:

<object application name> - <object short type> in <container document>

В противном случае заголовок должен быть следующим:

<object application name> - <container document>

Тип "короткий объект" относится к форме имени объекта, достаточно короткой, чтобы его можно было полностью отобразить в списке. Так как эти идентифицирующие строки не хранятся в постоянном состоянии объекта, IOleObject::SetHostNames необходимо вызывать при каждой загрузке или запуске объекта.

Требования

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

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

IOleObject

IOleObject::GetUserType