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 |
|---|---|
|
Memoria insufficiente disponibile per l'operazione. |
|
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 |