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:

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

Vedi anche

Ioleobject

IOleObject::Advise

IOleObject::Unadvise