Método IDataObject::EnumDAdvise (objidl.h)

Crea un objeto que se puede utilizar para enumerar las conexiones de consulta actuales.

Sintaxis

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

Parámetros

[out] ppenumAdvise

Puntero a una variable de puntero IEnumSTATDATA que recibe el puntero de interfaz al nuevo objeto enumerador. Si la implementación establece *ppnumAdvise en NULL, no hay ninguna conexión para avisar a los receptores en este momento.

Valor devuelto

Este método devuelve S_OK si se crea una instancia correcta del objeto del enumerador o no hay ninguna conexión. Otros valores posibles son los siguientes.

Código devuelto	Descripción
E_OUTOFMEMORY	La memoria insuficiente está disponible para la operación.
OLE_E_ADVISENOTSUPPORTED	Este objeto no admite las notificaciones de aviso.

Comentarios

El objeto enumerador creado por este método implementa la interfaz IEnumSTATDATA . IEnumSTATDATA permite la enumeración de los datos almacenados en una matriz de estructuras STATDATA . Cada una de estas estructuras proporciona información sobre una única conexión de asesoramiento e incluye información de FORMATETC y ADVF , así como el puntero al receptor de asesoramiento y el token que representa la conexión.

Notas a los autores de llamadas

Se recomienda usar el objeto de titular del aviso de datos OLE para controlar las conexiones de asesoramiento. Con el puntero obtenido a través de una llamada a CreateDataAdviseHolder, la implementación de IDataObject::EnumDAdvise se convierte en una cuestión sencilla de delegar la llamada a IDataAdviseHolder::EnumAdvise. Esto crea el enumerador y proporciona el puntero a la implementación OLE de IEnumSTATDATA. En ese momento, puede llamar a sus métodos para enumerar las conexiones de aviso actuales.

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	objidl.h

Consulte también

IDataAdviseHolder::EnumAdvise

IDataObject

IEnumSTATDATA