Функция OleCreateLink (ole2.h)
Создает связанный объект составного документа OLE.
Синтаксис
HRESULT OleCreateLink(
[in] LPMONIKER pmkLinkSrc,
[in] REFIID riid,
[in] DWORD renderopt,
[in] LPFORMATETC lpFormatEtc,
[in] LPOLECLIENTSITE pClientSite,
[in] LPSTORAGE pStg,
[out] LPVOID *ppvObj
);
Параметры
[in] pmkLinkSrc
Указатель на интерфейс IMoniker в моникере, который можно использовать для поиска источника связанного объекта.
[in] riid
Ссылка на идентификатор интерфейса, который позже будет использоваться вызывающим объектом для взаимодействия с новым объектом (обычно IID_IOleObject, определенный в заголовках OLE в качестве идентификатора интерфейса для IOleObject).
[in] renderopt
Задает значение из перечисления OLERENDER , указывающее возможности локально кэшированного рисования или извлечения данных, которые должен иметь только что созданный объект. Дополнительные рекомендации описаны в разделе "Примечания" ниже.
[in] lpFormatEtc
Указатель на значение из перечисления OLERENDER , указывающее возможности локально кэшированного рисования или извлечения данных, которые должен иметь только что созданный объект. Выбранное значение OLERENDER влияет на возможные значения для параметра lpFormatEtc .
[in] pClientSite
Указатель на экземпляр IOleClientSite, основной интерфейс, через который объект будет запрашивать службы из своего контейнера. Этот параметр может принимать значение NULL.
[in] pStg
Указатель на интерфейс IStorage в объекте хранилища. Этот параметр не может иметь значение NULL.
[out] ppvObj
Адрес переменной указателя, которая получает указатель интерфейса, запрошенный в riid. После успешного возврата *ppvObj содержит запрошенный указатель интерфейса на вновь созданный объект.
Возвращаемое значение
Эта функция возвращает S_OK об успешном выполнении. Ниже перечислены другие возможные значения.
| Код возврата | Описание |
|---|---|
|
Не удается выполнить привязку к источнику. |
Комментарии
Вызовите OleCreateLink , чтобы разрешить контейнеру создать ссылку на объект.
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | ole2.h |
| Библиотека | Ole32.lib |
| DLL | Ole32.dll |