GetRunningObjectTable, fonction (objbase.h)

Retourne un pointeur vers l’interface IRunningObjectTable sur la table d’objets en cours d’exécution locale (ROT).

Syntaxe

HRESULT GetRunningObjectTable(
  [in]  DWORD                reserved,
  [out] LPRUNNINGOBJECTTABLE *pprot
);

Paramètres

[in] reserved

Ce paramètre est réservé et doit être 0.

[out] pprot

Adresse d’une variable de pointeur IRunningObjectTable* qui reçoit le pointeur d’interface vers le ROT local. Lorsque la fonction réussit, l’appelant est chargé d’appeler Release sur le pointeur d’interface. Si une erreur se produit, *pprot n’est pas défini.

Valeur retournée

Cette fonction peut retourner les valeurs de retour standard E_UNEXPECTED et S_OK.

Remarques

Chaque station de travail a un ROT local qui gère une table des objets qui ont été inscrits comme s’exécutant sur cet ordinateur. Cette fonction retourne un pointeur d’interface IRunningObjectTable , qui fournit l’accès à cette table.

Les fournisseurs moniker, qui mettent à disposition des monikers qui identifient les objets afin qu’ils soient accessibles aux autres, doivent appeler GetRunningObjectTable. Utilisez le pointeur d’interface retourné par cette fonction pour inscrire vos objets lorsqu’ils commencent à s’exécuter, pour enregistrer les heures de modification de ces objets et pour révoquer leurs inscriptions lorsqu’ils cessent de s’exécuter. Pour plus d’informations, consultez l’interface IRunningObjectTable .

Les sources de liens de documents composés sont l’exemple le plus courant de fournisseurs de moniker. Il s’agit notamment des applications serveur qui prennent en charge la liaison à leurs documents (ou parties d’un document) et des applications conteneur qui prennent en charge la liaison à des incorporations dans leurs documents. Les applications serveur qui ne prennent pas en charge la liaison peuvent également utiliser le ROT pour coopérer avec les applications conteneur qui prennent en charge la liaison à des incorporations.

Si vous implémentez l’interface IMoniker pour écrire une nouvelle classe moniker et que vous avez besoin d’un pointeur d’interface vers le ROT, appelez IBindCtx ::GetRunningObjectTable plutôt que la fonction GetRunningObjectTable . Cela permet aux implémentations futures de l’interface IBindCtx de modifier le comportement de liaison.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	objbase.h
Bibliothèque	Ole32.lib
DLL	Ole32.dll
Ensemble d’API	ext-ms-win-com-ole32-l1-1-0 (introduit dans Windows 8)

Voir aussi

IBindCtx ::GetRunningObjectTable

IMoniker

IRunningObjectTable