Interfaz IBindCtx (objidl.h)
Proporciona acceso a un contexto de enlace, que es un objeto que almacena información sobre una operación de enlace de moniker determinada.
Herencia
La interfaz IBindCtx hereda de la interfaz IUnknown . IBindCtx también tiene estos tipos de miembros:
Métodos
La interfaz IBindCtx tiene estos métodos.
| IBindCtx::EnumObjectParam Recupera un puntero a una interfaz que se puede usar para enumerar las claves de la tabla de punteros con clave de cadena del contexto de enlace. |
| IBindCtx::GetBindOptions Recupera las opciones de enlace almacenadas en este contexto de enlace. |
| IBindCtx::GetObjectParam Recupera un puntero de interfaz al objeto asociado a la clave especificada en la tabla de punteros con clave de cadena del contexto de enlace. |
| IBindCtx::GetRunningObjectTable Recupera un puntero de interfaz a la tabla de objetos en ejecución (ROT) del equipo en el que se ejecuta este contexto de enlace. |
| IBindCtx::RegisterObjectBound Registra un objeto con el contexto de enlace para asegurarse de que el objeto permanece activo hasta que se libere el contexto de enlace. |
| IBindCtx::RegisterObjectParam Asocia un objeto a una clave de cadena en la tabla de punteros con clave de cadena del contexto de enlace. |
| IBindCtx::ReleaseBoundObjects Libera todos los punteros a todos los objetos que se registraron anteriormente mediante llamadas a RegisterObjectBound. |
| IBindCtx::RevokeObjectBound Quita el objeto del contexto de enlace, deshaciendo una llamada anterior a RegisterObjectBound. |
| IBindCtx::RevokeObjectParam Quita la clave especificada y su puntero asociado de la tabla de objetos con clave de cadena del contexto de enlace. La clave debe haberse insertado previamente en la tabla con una llamada a RegisterObjectParam. |
| IBindCtx::SetBindOptions Establece nuevos valores para los parámetros de enlace almacenados en el contexto de enlace. |
Comentarios
Un contexto de enlace incluye la siguiente información:
- Estructura BIND_OPTS que contiene un conjunto de parámetros que no cambian durante la operación de enlace. Cuando se enlaza un moniker compuesto, cada componente usa el mismo contexto de enlace, por lo que actúa como mecanismo para pasar los mismos parámetros a cada componente de un moniker compuesto.
- Un conjunto de punteros a objetos que la operación de enlace ha activado. El contexto de enlace contiene punteros a estos objetos enlazados, lo que los mantiene cargados y, por tanto, elimina las activaciones redundantes si los objetos son necesarios de nuevo durante las operaciones de enlace posteriores.
- Puntero a la tabla de objetos en ejecución (ROT) en el mismo equipo que el proceso que inició la operación de enlace. Las implementaciones de moniker que necesitan tener acceso a ROT deben usar el método IBindCtx::GetRunningObjectTable en lugar de usar la función GetRunningObjectTable . Esto permite futuras mejoras en la implementación de IBindCtx del sistema para modificar el comportamiento de enlace.
- Una tabla de punteros de interfaz, cada una asociada a una clave de cadena. Esta funcionalidad permite que las implementaciones de moniker almacenen punteros de interfaz en una cadena conocida para que se puedan recuperar posteriormente del contexto de enlace. Por ejemplo, OLE define varias claves de cadena ("ExceededDeadline", "ConnectManually", etc.) que se pueden usar para almacenar un puntero al objeto que provocó un error durante una operación de enlace.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | objidl.h |