Partager via

Fonction CoGetObjectContext (combaseapi.h)

  • Article

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