Método IOleContainer::EnumObjects (oleidl.h)

Enumera los objetos del contenedor actual.

Sintaxis

HRESULT EnumObjects(
  [in]  DWORD        grfFlags,
  [out] IEnumUnknown **ppenum
);

Parámetros

[in] grfFlags

Especifica qué objetos de un contenedor se van a enumerar, tal como se define en la enumeración OLECONTF.

[out] ppenum

Puntero a una variable de puntero IEnumUnknown que recibe el puntero de interfaz al objeto enumerador. Cada vez que un contenedor recibe una llamada correcta a EnumObjects, debe aumentar el recuento de referencias en el punteroppnum que devuelve el método. Es responsabilidad del autor de la llamada llamar a IUnknown::Release cuando se realiza con el puntero. Si se devuelve un error, la implementación debe establecerppnum enNULL.

Valor devuelto

Este método devuelve S_OK cuando funciona correctamente. Otros posibles valores devueltos son los siguientes.

Código devuelto	Descripción
E_FAIL	Error en la operación.
E_NOTIMPL	No se admite la enumeración de objetos.

Comentarios

Un contenedor debe implementar EnumObjects para permitir a los clientes mediante programación averiguar qué objetos contiene. Sin embargo, no se llama a este método en escenarios de vinculación estándar.

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	oleidl.h

Consulte también

IEnumUnknown

IOleContainer

IOleItemContainer

OLECONTF