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

  • Artículo

Recupera un puntero a un enumerador que se puede usar para enumerar las conexiones de aviso registradas para un objeto, por lo que un contenedor puede saber qué liberar antes de cerrar.

Sintaxis

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

Parámetros

[out] ppenumAdvise

Dirección de la variable de puntero IEnumSTATDATA que recibe el puntero de interfaz al objeto enumerador. Si el objeto no tiene ninguna conexión de aviso o si se produce un error, la implementación debe establecerppnumAdvise en NULL. Cada vez que un objeto recibe una llamada correcta a IOleObject::EnumAdvise, debe aumentar el recuento de referencias enppnumAdvise. Es responsabilidad del autor de la llamada llamar a Release cuando se hace con el epinumAdvise.

Valor devuelto

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

Código devuelto Descripción
E_NOTIMPL

IOleObject::EnumAdvise no está implementado.

Comentarios

El método IOleObject::EnumAdvise proporciona un enumerador que proporciona una manera de que los contenedores realicen un seguimiento de las conexiones de asesoramiento registradas para sus objetos. Normalmente, un contenedor llamaría a esta función para que pueda indicar a un objeto que libere cada una de sus conexiones de asesoramiento antes de cerrarse.

El enumerador al que obtiene acceso a través de IOleObject::EnumAdvise enumera los elementos de tipo STATDATA. Después de recibir el puntero, el contenedor puede recorrer STATDATA y llamar a IOleObject::Unadvise para cada conexión enumerada.

La manera habitual de implementar esta función es delegar la llamada a la interfaz IOleAdviseHolder . Solo los miembros pAdvise y dwConnection de STATDATA son relevantes para IOleObject::EnumAdvise.

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

IOleObject

IOleObject::Advise

IOleObject::Unadvise