Fonction CoGetObjectContext (combaseapi.h)

Article
08/22/2023

Retourne le contexte de l’objet actif.

Syntaxe

HRESULT CoGetObjectContext(
  [in]  REFIID riid,
  [out] LPVOID *ppv
);

Paramètres

[in] riid

Référence à l’ID d’une interface implémentée sur l’objet de contexte.

Pour les objets s’exécutant dans des applications COM, IID_IComThreadingInfo, IID_IContext et IID_IContextCallback sont disponibles.

Pour les objets s’exécutant dans des applications COM+, IID_IObjectContext, IID_IObjectContextActivity IID_IObjectContextInfo et IID_IContextState sont disponibles.

[out] ppv

Adresse d’un pointeur vers l’interface spécifiée par riid sur l’objet de contexte.

Valeur retournée

Cette fonction peut retourner les valeurs de retour standard E_OUTOFMEMORY et E_UNEXPECTED, ainsi que les valeurs suivantes.

Code de retour	Description
S_OK	Le contexte de l’objet a été récupéré avec succès.
E_NOINTERFACE	L’interface demandée n’était pas disponible.
CO_E_NOTINITIALIZED	Pour que cette fonction puisse être appelée, la fonction CoInitializeEx doit être appelée sur le thread actif.

Remarques

CoGetObjectContext récupère le contexte de l’objet à partir duquel il est appelé et retourne un pointeur vers une interface qui peut être utilisé pour manipuler les propriétés de contexte. Les propriétés de contexte sont utilisées pour fournir des services aux composants configurés s’exécutant dans les applications COM+.

Pour les composants s’exécutant dans des applications COM, les interfaces suivantes sont prises en charge pour accéder aux propriétés de contexte : IComThreadingInfo, IContext et IContextCallback.

Pour les composants s’exécutant dans les applications COM+, les interfaces suivantes sont prises en charge pour accéder aux propriétés de contexte : IObjectContext, IObjectContextActivity, IObjectContextInfo et IContextState.

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	combaseapi.h (inclure Objbase.h)
Bibliothèque	Ole32.lib
DLL	Ole32.dll

Voir aussi

Contextes et modèles de threads

Partager via