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 |
|---|---|
|
La memoria insuficiente está disponible para la operación. |
|
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 |