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

Artículo
08/25/2023

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