Interface IBindCtx (objidl.h)

Article
02/29/2024

Fournit l’accès à un contexte de liaison, qui est un objet qui stocke des informations sur une opération de liaison moniker particulière.

Héritage

L’interface IBindCtx hérite de l’interface IUnknown. IBindCtx a également les types de membres suivants :

Méthodes

L’interface IBindCtx a ces méthodes.


IBindCtx ::EnumObjectParam Récupère un pointeur vers une interface qui peut être utilisé pour énumérer les clés de la table de pointeurs à clé de chaîne du contexte de liaison.
IBindCtx ::GetBindOptions Récupère les options de liaison stockées dans ce contexte de liaison.
IBindCtx ::GetObjectParam Récupère un pointeur d’interface vers l’objet associé à la clé spécifiée dans la table de pointeurs à clé de chaîne du contexte de liaison.
IBindCtx ::GetRunningObjectTable Récupère un pointeur d’interface vers la table d’objets en cours d’exécution (ROT) pour l’ordinateur sur lequel ce contexte de liaison s’exécute.
IBindCtx ::RegisterObjectBound Inscrit un objet avec le contexte de liaison pour s’assurer que l’objet reste actif jusqu’à ce que le contexte de liaison soit libéré.
IBindCtx ::RegisterObjectParam Associe un objet à une clé de chaîne dans la table de pointeurs à clé de chaîne du contexte de liaison.
IBindCtx ::ReleaseBoundObjects Libère tous les pointeurs vers tous les objets précédemment inscrits par les appels à RegisterObjectBound.
IBindCtx ::RevokeObjectBound Supprime l’objet du contexte de liaison, en annulant un appel précédent à RegisterObjectBound.
IBindCtx ::RevokeObjectParam Supprime la clé spécifiée et son pointeur associé de la table d’objets à clé de chaîne du contexte de liaison. La clé doit avoir été précédemment insérée dans la table avec un appel à RegisterObjectParam.
IBindCtx ::SetBindOptions Définit de nouvelles valeurs pour les paramètres de liaison stockés dans le contexte de liaison.

Remarques

Un contexte de liaison inclut les informations suivantes :

Structure BIND_OPTS contenant un ensemble de paramètres qui ne changent pas pendant l’opération de liaison. Lorsqu’un moniker composite est lié, chaque composant utilise le même contexte de liaison. Il agit donc comme un mécanisme pour transmettre les mêmes paramètres à chaque composant d’un moniker composite.
Ensemble de pointeurs vers des objets que l’opération de liaison a activés. Le contexte de liaison contient des pointeurs vers ces objets liés, les maintenant chargés et éliminant ainsi les activations redondantes si les objets sont à nouveau nécessaires lors des opérations de liaison suivantes.
Pointeur vers la table d’objets en cours d’exécution (ROT) sur le même ordinateur que le processus qui a démarré l’opération de liaison. Les implémentations Moniker qui doivent accéder au ROT doivent utiliser la méthode IBindCtx ::GetRunningObjectTable plutôt que la fonction GetRunningObjectTable . Cela permet des améliorations ultérieures de l’implémentation IBindCtx du système pour modifier le comportement de liaison.
Table de pointeurs d’interface, chacun associé à une clé de chaîne. Cette fonctionnalité permet aux implémentations moniker de stocker des pointeurs d’interface sous une chaîne connue afin qu’ils puissent être récupérés ultérieurement à partir du contexte de liaison. Par exemple, OLE définit plusieurs clés de chaîne (« ExceededDeadline », « ConnectManually », etc.) qui peuvent être utilisées pour stocker un pointeur vers l’objet qui a provoqué une erreur lors d’une opération de liaison.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	objidl.h

Voir aussi