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

  • Artículo

Crea y devuelve un puntero a un enumerador que puede enumerar los monikers de todos los objetos registrados actualmente en la tabla de objetos en ejecución (ROT).

Sintaxis

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

Parámetros

[out] ppenumMoniker

Puntero a una variable de puntero IEnumMoniker que recibe el puntero de interfaz al nuevo enumerador para rot. Cuando se ejecuta correctamente, la implementación llama a AddRef en el enumerador; es responsabilidad del autor de la llamada llamar a Release. Si se produce un error; la implementación establece *ppnumMoniker en NULL.

Valor devuelto

Este método puede devolver los valores devueltos estándar E_OUTOFMEMORY y S_OK.

Comentarios

IRunningObjectTable::EnumRunning debe crear y devolver un puntero a una interfaz IEnumMoniker en un objeto enumerador. A continuación, se puede llamar a los métodos de enumerador estándar para enumerar los monikers registrados actualmente en el registro. El enumerador no se puede usar para enumerar monikers registrados en el ROT después de crear el enumerador.

El método EnumRunning está pensado principalmente para el uso del sistema en la implementación de la tabla de objetos de alerta. Tenga en cuenta que OLE 2 no incluye una implementación de la tabla de objetos de alerta.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado objidl.h

Consulte también

IEnumMoniker

IRunningObjectTable