Интерфейс 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 |