Metodo IOleObject::Unadvise (oleidl.h)

Elimina una connessione consultiva stabilita in precedenza.

Sintassi

HRESULT Unadvise(
  [in] DWORD dwConnection
);

Parametri

[in] dwConnection

Contiene un token di valore diverso da zero, restituito in precedenza da IOleObject::Advise tramite il parametro 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
E_FAIL	Operazione non riuscita.
OLE_E_NOCONNECTION	dwConnection non rappresenta una connessione consultiva valida.

Commenti

In genere, i contenitori chiamano IOleObject::Unadvise 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 come metodo per ridurre il sovraccarico di gestione di più connessioni consultive. Il modo più semplice per implementare questo metodo consiste nel delegare la chiamata a IOleObject::Unadvise.

Requisiti

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::Unadvise

Ioleobject

IOleObject::Advise

IOleObject::EnumAdvise