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