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