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

  • Artigo

Exclui uma conexão de consultoria estabelecida anteriormente.

Sintaxe

HRESULT Unadvise(
  [in] DWORD dwConnection
);

Parâmetros

[in] dwConnection

Contém um token de valor diferente de zero, que foi retornado anteriormente de IOleObject::Advise por meio de seu parâmetro pdwConnection .

Valor retornado

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

Código de retorno Descrição
E_FAIL
 Falha na operação.
OLE_E_NOCONNECTION
 dwConnection não representa uma conexão de consultoria válida.

Comentários

Normalmente, os contêineres chamam IOleObject::Unadvise 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 que atualmente não estão visíveis como uma maneira de reduzir a sobrecarga de manutenção de várias conexões de consultoria. A maneira mais fácil de implementar esse método é delegar a chamada para IOleObject::Unadvise.

Requisitos

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

Ioleobject

IOleObject::Advise

IOleObject::EnumAdvise