Méthode IBindCtx::SetBindOptions (objidl.h)

Article
08/25/2023

Définit de nouvelles valeurs pour les paramètres de liaison stockés dans le contexte de liaison.

Syntaxe

HRESULT SetBindOptions(
  [in] BIND_OPTS *pbindopts
);

Paramètres

[in] pbindopts

Pointeur vers une structure de BIND_OPTS3 contenant les paramètres de liaison.

Valeur retournée

Cette méthode peut retourner les valeurs de retour standard E_OUTOFMEMORY et S_OK.

Notes

Un contexte de liaison contient un bloc de paramètres communs à la plupart des opérations IMoniker . Ces paramètres ne changent pas lorsque l’opération se déplace d’une pièce à l’autre d’un moniker composite.

Les opérations de liaison suivantes peuvent appeler IBindCtx::GetBindOptions pour récupérer ces paramètres.

Remarques aux appelants

Cette méthode peut être appelée par les clients moniker (ceux qui utilisent des monikers pour acquérir des pointeurs d’interface vers des objets).

Lorsque vous créez pour la première fois un contexte de liaison à l’aide de la fonction CreateBindCtx , les champs de la structure BIND_OPTS sont initialisés avec les valeurs suivantes :

    cbStruct = sizeof(BIND_OPTS); 
    grfFlags = 0; 
    grfMode = STGM_READWRITE; 
    dwTickCountDeadline = 0;

Vous pouvez utiliser la méthode IBindCtx::SetBindOptions pour modifier ces valeurs avant d’utiliser le contexte de liaison, si vous souhaitez des valeurs autres que les valeurs par défaut.

SetBindOptions copie les membres de la structure spécifiée, mais pas la structure COSERVERINFO et les pointeurs qu’elle contient. Les appelants peuvent ne pas libérer ces pointeurs tant que le contexte de liaison n’est pas libéré.

Spécifications


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