Metodo IOleAdviseHolder::EnumAdvise (oleidl.h)

Articolo
03/01/2024

Crea un enumeratore che può essere utilizzato per enumerare le connessioni consultive attualmente stabilite per un oggetto .

Sintassi

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

Parametri

[out] ppenumAdvise

Puntatore a una variabile puntatore IEnumSTATDATA che riceve il puntatore di interfaccia al nuovo enumeratore. Se questo parametro è NULL, non sono presenti connessioni consultive sull'oggetto o si è verificato un errore. Il titolare del consiglio è responsabile dell'incremento del conteggio dei riferimenti sul puntatore IEnumSTATDATA fornito da questo metodo. È responsabilità del chiamante chiamare IUnknown::Release al termine del puntatore.

Valore restituito

Questo metodo restituisce S_OK se l'operazione ha esito positivo. Gli altri valori restituiti possibili includono i seguenti:

Codice restituito	Descrizione
E_FAIL	L'operazione di enumerazione non è riuscita.
E_NOTIMPL	IOleAdviseHolder::EnumAdvise non è implementato.

Commenti

IOleAdviseHolder::EnumAdvise crea un enumeratore che può essere usato per enumerare le connessioni consultive stabilite di un oggetto. Il metodo fornisce un puntatore all'interfaccia IEnumSTATDATA in questo enumeratore. Le informazioni di connessione consultive per ogni connessione vengono archiviate nella struttura STATDATA e l'enumeratore deve essere in grado di enumerare queste strutture.

Per questo metodo, gli unici membri della struttura pertinenti sono pAdvise e dwConnection. Altri membri contengono informazioni di consulenza sui dati. Quando si chiamano i metodi di enumerazione e mentre è in corso un'enumerazione, l'effetto della registrazione o della revoca delle connessioni consultive su ciò che deve essere enumerato non è definito.

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