Share via

Интерфейс IBindCtx (objidl.h)

  • Статья

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

Наследование

Интерфейс IBindCtx наследуется от интерфейса IUnknown . IBindCtx также имеет следующие типы элементов:

Методы

Интерфейс IBindCtx содержит следующие методы.

 
IBindCtx::EnumObjectParam

Извлекает указатель на интерфейс, который можно использовать для перечисления ключей таблицы указателей с ключами со строковым ключом контекста привязки.
IBindCtx::GetBindOptions

Извлекает параметры привязки, хранящиеся в этом контексте привязки.
IBindCtx::GetObjectParam

Извлекает указатель интерфейса на объект, связанный с указанным ключом в таблице указателей с ключом со строковым ключом контекста привязки.
IBindCtx::GetRunningObjectTable

Извлекает указатель интерфейса на таблицу выполняющихся объектов (ROT) для компьютера, на котором выполняется этот контекст привязки.
IBindCtx::RegisterObjectBound

Регистрирует объект в контексте привязки, чтобы гарантировать, что объект остается активным до тех пор, пока контекст привязки не будет освобожден.
IBindCtx::RegisterObjectParam

Связывает объект со строковым ключом в таблице указателей контекста привязки.
IBindCtx::ReleaseBoundObjects

Освобождает все указатели на все объекты, которые были ранее зарегистрированы вызовами RegisterObjectBound.
IBindCtx::RevokeObjectBound

Удаляет объект из контекста привязки, отменяя предыдущий вызов RegisterObjectBound.
IBindCtx::RevokeObjectParam

Удаляет указанный ключ и связанный с ним указатель из таблицы объектов с ключом к строкам контекста привязки. Ключ должен быть ранее вставлен в таблицу с вызовом RegisterObjectParam.
IBindCtx::SetBindOptions

Задает новые значения для параметров привязки, хранящихся в контексте привязки.

Комментарии

Контекст привязки содержит следующие сведения:

  • Структура BIND_OPTS , содержащая набор параметров, которые не изменяются во время операции привязки. При привязке составного моникера каждый компонент использует один и тот же контекст привязки, поэтому он выступает в качестве механизма для передачи одинаковых параметров каждому компоненту составного моникера.
  • Набор указателей на объекты, активированные операцией привязки. Контекст привязки содержит указатели на эти привязанные объекты, сохраняя их загрузку и тем самым устраняя избыточные активации, если объекты снова понадобятся во время последующих операций привязки.
  • Указатель на таблицу выполняющихся объектов (ROT) на том же компьютере, что и процесс, запустивший операцию привязки. Реализации моникера, которым требуется доступ к ROT, должны использовать метод IBindCtx::GetRunningObjectTable , а не функцию GetRunningObjectTable . Это позволяет в будущем усовершенствовать реализацию IBindCtx системы, чтобы изменить поведение привязки.
  • Таблица указателей интерфейса, каждый из которых связан со строковым ключом. Эта возможность позволяет реализации моникера хранить указатели интерфейса в хорошо известной строке, чтобы впоследствии их можно было получить из контекста привязки. Например, OLE определяет несколько строковых ключей ("ExceededDeadline", "ConnectManually" и т. д.), которые можно использовать для хранения указателя на объект, вызвавший ошибку во время операции привязки.

Требования

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

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

CreateBindCtx

IMoniker

IOleItemContainer

IParseDisplayName