Méthode IRunningObjectTable ::EnumRunning (objidl.h)

Crée et retourne un pointeur vers un énumérateur qui peut répertorier les monikers de tous les objets actuellement inscrits dans la table d’objets en cours d’exécution (ROT).

Syntaxe

HRESULT EnumRunning(
  [out] IEnumMoniker **ppenumMoniker
);

Paramètres

[out] ppenumMoniker

Pointeur vers une variable de pointeur IEnumMoniker qui reçoit le pointeur d’interface vers le nouvel énumérateur pour le ROT. En cas de réussite, l’implémentation appelle AddRef sur l’énumérateur ; il incombe à l’appelant d’appeler Release. Si une erreur se produit ; l’implémentation définit *ppenumMoniker sur NULL.

Valeur retournée

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

Remarques

IRunningObjectTable ::EnumRunning doit créer et retourner un pointeur vers une interface IEnumMoniker sur un objet énumérateur. Les méthodes d’énumérateur standard peuvent ensuite être appelées pour énumérer les monikers actuellement inscrits dans le registre. L’énumérateur ne peut pas être utilisé pour énumérer les monikers qui sont inscrits dans le ROT après la création de l’énumérateur.

La méthode EnumRunning est principalement destinée à être utilisée par le système dans l’implémentation de la table d’objets d’alerte. Notez qu’OLE 2 n’inclut pas d’implémentation de la table d’objets d’alerte.

Configuration requise

Voir aussi

IEnumMoniker

IRunningObjectTable