Metodo IOleAdviseHolder::Unadvise (oleidl.h)

Elimina una connessione consultiva stabilita in precedenza.

Sintassi

HRESULT Unadvise(
  [in] DWORD dwConnection
);

Parametri

[in] dwConnection

Valore restituito in precedenza da IOleAdviseHolder::Advise in pdwConnection.

Valore restituito

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

Codice restituito	Descrizione
OLE_E_NOCONNECTION	Il parametro dwConnection non rappresenta una connessione consultiva valida.

Commenti

IOleAdviseHolder::Unadvise deve essere usato per implementare IOleObject::Unadvise per eliminare una connessione consultiva. In generale, si userebbe il titolare del consiglio OLE avendo ottenuto un puntatore tramite una chiamata a CreateOleAdviseHolder.

In genere, i contenitori chiamano questo metodo all'arresto o quando viene eliminato un oggetto. In alcuni casi, i contenitori possono chiamare questo metodo su oggetti in esecuzione ma attualmente non visibili, in modo da ridurre l'overhead di gestione di più connessioni consultive.

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

Vedi anche

IOleAdviseHolder

IOleAdviseHolder::Advise

IOleAdviseHolder::EnumAdvise

IOleObject::Unadvise