Partager via


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

Récupère un pointeur d’interface vers la table d’objets en cours d’exécution (ROT) pour l’ordinateur sur lequel ce contexte de liaison s’exécute.

Syntaxe

HRESULT GetRunningObjectTable(
  [out] IRunningObjectTable **pprot
);

Paramètres

[out] pprot

Adresse d’une variable de pointeur IRunningObjectTable* qui reçoit le pointeur d’interface vers la table d’objets en cours d’exécution. Si une erreur se produit, *pprot a la valeur NULL. Si *pprot n’a pas la valeur NULL, l’implémentation appelle AddRef sur l’objet table en cours d’exécution ; il incombe à l’appelant d’appeler Release.

Valeur retournée

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

Remarques

La table d’objets en cours d’exécution est une table accessible globalement sur chaque ordinateur. Il effectue le suivi de tous les objets en cours d’exécution sur l’ordinateur.

Remarques aux appelants

En règle générale, ceux qui implémentent une nouvelle classe moniker (via une implémentation de l’interface IMoniker ) appellent GetRunningObjectTable. Il est utile d’appeler cette méthode dans une implémentation de IMoniker ::BindToObject ou IMoniker ::IsRunning pour case activée si un objet est en cours d’exécution. Vous pouvez également appeler cette méthode dans l’implémentation de IMoniker ::GetTimeOfLastChange pour savoir quand un objet en cours d’exécution a été modifié pour la dernière fois.

Les implémentations Moniker doivent appeler cette méthode au lieu d’utiliser la fonction GetRunningObjectTable . Cela permet aux futures implémentations d’IBindCtx de modifier le comportement de liaison.

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

IMoniker

IRunningObjectTable