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.

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

Consulte también

IDataAdviseHolder::EnumAdvise

IOleAdviseHolder

IOleAdviseHolder::Advise

IOleAdviseHolder::Unadvise

IOleObject::EnumAdvise

STATDATA