Método IOleObject::EnumAdvise (oleidl.h)
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 |
---|---|
|
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 |