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

Elimina una conexión de asesoramiento establecida previamente.

Sintaxis

HRESULT Unadvise(
  [in] DWORD dwConnection
);

Parámetros

[in] dwConnection

Valor devuelto anteriormente por IOleAdviseHolder::Advise en pdwConnection.

Valor devuelto

Este método devuelve S_OK cuando funciona correctamente. Otros posibles valores devueltos son los siguientes.

Código devuelto	Descripción
OLE_E_NOCONNECTION	El parámetro dwConnection no representa una conexión de asesoramiento válida.

Comentarios

IOleAdviseHolder::Unadvise está pensado para usarse para implementar IOleObject::Unadvise para eliminar una conexión de asesoramiento. En general, usaría el titular del aviso OLE que ha obtenido un puntero a través de una llamada a CreateOleAdviseHolder.

Normalmente, los contenedores llaman a este método durante el apagado o cuando se elimina un objeto. En ciertos casos, los contenedores podrían llamar a este método en objetos que se ejecutan pero que no están visibles actualmente, como una manera de reducir la sobrecarga de mantener varias conexiones de asesoramiento.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	oleidl.h

Consulte también

IOleAdviseHolder

IOleAdviseHolder::Advise

IOleAdviseHolder::EnumAdvise

IOleObject::Unadvise