Compartir a través de


Método IOleAdviseHolder::EnumAdvise (oleidl.h)

Crea un enumerador que se puede usar para enumerar las conexiones de asesoramiento establecidas actualmente para un objeto .

Sintaxis

HRESULT EnumAdvise(
  [out] IEnumSTATDATA **ppenumAdvise
);

Parámetros

[out] ppenumAdvise

Puntero a una variable de puntero IEnumSTATDATA que recibe el puntero de interfaz al nuevo enumerador. Si este parámetro es NULL, actualmente no hay ninguna conexión de aviso en el objeto o se produjo un error. El titular del aviso es responsable de incrementar el recuento de referencias en el puntero IEnumSTATDATA que proporciona este método. Es responsabilidad del autor de la llamada llamar a IUnknown::Release cuando termine con el puntero.

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 de enumeración.
E_NOTIMPL

IOleAdviseHolder::EnumAdvise no está implementado.

Comentarios

IOleAdviseHolder::EnumAdvise crea un enumerador que se puede usar para enumerar las conexiones de asesoramiento establecidas de un objeto. El método proporciona un puntero a la interfaz IEnumSTATDATA en este enumerador. La información de conexión de asesoramiento para cada conexión se almacena en la estructura STATDATA y el enumerador debe ser capaz de enumerar estas estructuras.

Para este método, los únicos miembros de estructura relevantes son pAdvise y dwConnection. Otros miembros contienen información de aviso de datos. Cuando se llama a los métodos de enumeración y mientras una enumeración está en curso, el efecto de registrar o revocar las conexiones de asesoramiento en lo que se va a enumerar no está definido.

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

IDataAdviseHolder::EnumAdvise

IOleAdviseHolder

IOleAdviseHolder::Advise

IOleAdviseHolder::Unadvise

IOleObject::EnumAdvise

STATDATA