Metodo IDataObject::EnumDAdvise (objidl.h)

Crea un oggetto che può essere usato per enumerare le connessioni consultive correnti.

Sintassi

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

Parametri

[out] ppenumAdvise

Puntatore a una variabile puntatore IEnumSTATDATA che riceve il puntatore dell'interfaccia al nuovo oggetto enumeratore. Se l'implementazione imposta *ppenumAdvise su NULL, non sono presenti connessioni per consigliare i sink in questo momento.

Valore restituito

Questo metodo restituisce S_OK se l'oggetto enumeratore viene creato correttamente o non sono presenti connessioni. Altri valori possibili includono quanto segue.

Codice restituito	Descrizione
E_OUTOFMEMORY	Memoria insufficiente disponibile per l'operazione.
OLE_E_ADVISENOTSUPPORTED	Le notifiche di consulenza non sono supportate da questo oggetto.

Commenti

L'oggetto enumeratore creato da questo metodo implementa l'interfaccia IEnumSTATDATA . IEnumSTATDATA consente l'enumerazione dei dati archiviati in una matrice di strutture STATDATA . Ognuna di queste strutture fornisce informazioni su una singola connessione consultiva e include informazioni FORMATETC e ADVF , nonché il puntatore al sink di consulenza e al token che rappresenta la connessione.

Note ai chiamanti

È consigliabile usare l'oggetto proprietario dei dati OLE per gestire le connessioni consultive. Con il puntatore ottenuto tramite una chiamata a CreateDataAdviseHolder, l'implementazione di IDataObject::EnumDAdvise diventa una semplice questione di delega della chiamata a IDataAdviseHolder::EnumAdvise. In questo modo viene creato l'enumeratore e viene fornito il puntatore all'implementazione OLE di IEnumSTATDATA. A questo punto, è possibile chiamare i relativi metodi per enumerare le connessioni di consulenza correnti.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	objidl.h

Vedi anche

IDataAdviseHolder::EnumAdvise

Idataobject

IEnumSTATDATA