Compartilhar via


Método IOleAdviseHolder::Unadvise (oleidl.h)

Exclui uma conexão de consultoria estabelecida anteriormente.

Sintaxe

HRESULT Unadvise(
  [in] DWORD dwConnection
);

Parâmetros

[in] dwConnection

O valor retornado anteriormente por IOleAdviseHolder::Advise em pdwConnection.

Retornar valor

Esse método retorna S_OK em caso de êxito. Outros valores retornados possíveis incluem o seguinte.

Código de retorno Descrição
OLE_E_NOCONNECTION
O parâmetro dwConnection não representa uma conexão de consultoria válida.

Comentários

IOleAdviseHolder::Unadvise destina-se a ser usado para implementar IOleObject::Unadvise para excluir uma conexão de consultoria. Em geral, você usaria o titular da consultoria OLE tendo obtido um ponteiro por meio de uma chamada para CreateOleAdviseHolder.

Normalmente, os contêineres chamam esse método no desligamento ou quando um objeto é excluído. Em determinados casos, os contêineres podem chamar esse método em objetos que estão em execução, mas não estão visíveis no momento, como uma forma de reduzir a sobrecarga de manter várias conexões de consultoria.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho oleidl.h

Confira também

Ioleadviseholder

IOleAdviseHolder::Advise

IOleAdviseHolder::EnumAdvise

IOleObject::Unadvise