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