IBindCtx ::GetObjectParam, méthode (objidl.h)

Article
03/06/2024

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.

Syntaxe

HRESULT GetObjectParam(
  [in]  LPOLESTR pszKey,
  [out] IUnknown **ppunk
);

Paramètres

[in] pszKey

Clé de chaîne de contexte de liaison à rechercher. La comparaison de chaînes de clés respecte la casse.

[out] ppunk

Adresse d’une variable pointeur IUnknown* qui reçoit le pointeur d’interface vers l’objet associé à pszKey. En cas de réussite, l’implémentation appelle AddRef sur *ppunk. Il incombe à l’appelant d’appeler Release. Si une erreur se produit, l’implémentation définit *ppunk sur NULL.

Valeur retournée

Si la méthode réussit, la valeur de retour est S_OK. Sinon, c’est E_FAIL.

Remarques

Un contexte de liaison gère une table de pointeurs d’interface, chacun associé à une clé de chaîne. Cela permet la communication entre une implémentation moniker et l’appelant qui a lancé l’opération de liaison. Une partie peut stocker un pointeur d’interface sous une chaîne connue des deux parties afin que l’autre partie puisse le récupérer ultérieurement à partir du contexte de liaison.

Le pointeur récupéré par cette méthode doit avoir déjà été inséré dans la table à l’aide de la méthode IBindCtx ::RegisterObjectParam .

Remarques aux appelants

Les objets utilisant des monikers pour localiser d’autres objets peuvent appeler cette méthode lorsqu’une opération de liaison ne parvient pas à obtenir des informations spécifiques sur l’erreur qui s’est produite. Selon l’erreur, il peut être possible de corriger la situation et de réessayer l’opération de liaison. Pour plus d’informations , consultez IBindCtx ::RegisterObjectParam .

Les implémentations Moniker peuvent appeler cette méthode pour gérer les situations où un appelant lance une opération de liaison et demande des informations spécifiques. Par convention, l’implémenteur doit utiliser des noms de clés qui commencent par la forme de chaîne du CLSID d’une classe moniker. (Consultez la fonction StringFromCLSID .)

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

IBindCtx

Partager via