Metodo IOleObject::EnumAdvise (oleidl.h)
Recupera un puntatore a un enumeratore che può essere usato per enumerare le connessioni consultive registrate per un oggetto, in modo che un contenitore possa sapere cosa rilasciare prima della chiusura.
Sintassi
HRESULT EnumAdvise(
[out] IEnumSTATDATA **ppenumAdvise
);
Parametri
[out] ppenumAdvise
Indirizzo della variabile puntatore IEnumSTATDATA che riceve il puntatore dell'interfaccia all'oggetto enumeratore. Se l'oggetto non dispone di connessioni consultive o se si verifica un errore, l'implementazione deve impostare ppenumAdvise su NULL. Ogni volta che un oggetto riceve una chiamata riuscita a IOleObject::EnumAdvise, deve aumentare il conteggio dei riferimenti su ppenumAdvise. È responsabilità del chiamante chiamare Release quando viene fatto con il ppenumAdvise.
Valore restituito
Questo metodo restituisce S_OK se l'operazione ha esito positivo. Gli altri valori restituiti possibili includono i seguenti:
| Codice restituito | Descrizione |
|---|---|
|
IOleObject::EnumAdvise non è implementato. |
Commenti
Il metodo IOleObject::EnumAdvise fornisce un enumeratore che consente ai contenitori di tenere traccia delle connessioni consultive registrate per i relativi oggetti. Un contenitore normalmente chiamerebbe questa funzione in modo che possa indicare a un oggetto di rilasciare ognuna delle relative connessioni consultive prima della chiusura.
L'enumeratore a cui si ottiene l'accesso tramite IOleObject::EnumAdvise enumera gli elementi di tipo STATDATA. Dopo aver ricevuto il puntatore, il contenitore può quindi scorrere STATDATA e chiamare IOleObject::Unadvise per ogni connessione enumerata.
Il modo consueto per implementare questa funzione consiste nel delegare la chiamata all'interfaccia IOleAdviseHolder . Solo i membri pAdvise e dwConnection di STATDATA sono rilevanti per IOleObject::EnumAdvise.
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 | oleidl.h |