CreateBindCtx, fonction (objbase.h)
Retourne un pointeur vers une implémentation de IBindCtx (objet de contexte de liaison). Cet objet stocke des informations sur une opération de liaison de moniker particulière.
Syntaxe
HRESULT CreateBindCtx(
[in] DWORD reserved,
[out] LPBC *ppbc
);
Paramètres
[in] reserved
Ce paramètre est réservé et doit être 0.
[out] ppbc
Adresse d’une variable pointeur IBindCtx* qui reçoit le pointeur d’interface vers le nouvel objet de contexte de liaison. Lorsque la fonction réussit, l’appelant est chargé d’appeler Release sur le contexte de liaison. Une valeur NULL pour le contexte de liaison indique qu’une erreur s’est produite.
Valeur retournée
Cette fonction peut retourner les valeurs de retour standard E_OUTOFMEMORY et S_OK.
Remarques
CreateBindCtx est le plus couramment utilisé dans le processus de liaison d’un moniker (localisation et obtention d’un pointeur vers une interface en l’identifiant via un moniker), comme dans les étapes suivantes :
- Obtenez un pointeur vers un contexte de liaison en appelant la fonction CreateBindCtx .
- Appelez la méthode IMoniker ::BindToObject sur le moniker, en récupérant un pointeur d’interface vers l’objet auquel le moniker fait référence.
- Libérez le contexte de liaison.
- Utilisez le pointeur d’interface.
- Relâchez le pointeur d’interface.
// pMnk is an IMoniker * that points to a previously acquired moniker
IInterface *pInterface;
IBindCtx *pbc;
CreateBindCtx( 0, &pbc );
pMnk->BindToObject( pbc, NULL, IID_IInterface, &pInterface );
pbc->Release();
// pInterface now points to the object; safe to use pInterface
pInterface->Release();
Les contextes de liaison sont également utilisés dans d’autres méthodes de l’interface IMoniker en plus de IMoniker ::BindToObject et dans la fonction MkParseDisplayName .
Un contexte de liaison conserve les références aux objets liés pendant l’opération de liaison, ce qui fait que les objets liés restent actifs (en maintenant le serveur de l’objet en cours d’exécution) jusqu’à ce que le contexte de liaison soit libéré. La réutilisation d’un contexte de liaison lorsque les opérations suivantes sont liées au même objet peut améliorer les performances. Toutefois, vous devez libérer le contexte de liaison dès que possible, car vous pouvez conserver les objets activés inutilement.
Un contexte de liaison contient une structure BIND_OPTS , qui contient des paramètres qui s’appliquent à toutes les étapes d’une opération de liaison. Lorsque vous créez un contexte de liaison à l’aide de CreateBindCtx, les champs de la structure BIND_OPTS sont initialisés comme suit.
cbStruct = sizeof(BIND_OPTS)
grfFlags = 0
grfMode = STGM_READWRITE
dwTickCountDeadline = 0
Vous pouvez appeler la méthode IBindCtx ::SetBindOptions pour modifier ces valeurs par défaut.
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 | objbase.h |
| Bibliothèque | Ole32.lib |
| DLL | Ole32.dll |