Método IOleInPlaceObject::InPlaceDeactivate (oleidl.h)
Desactiva un objeto activo en contexto y descarta el estado de deshacer del objeto.
Sintaxis
HRESULT InPlaceDeactivate();
Valor devuelto
Este método devuelve S_OK cuando funciona correctamente. Otros posibles valores devueltos son los siguientes.
| Código devuelto | Descripción |
|---|---|
|
Se ha producido un error inesperado. |
Comentarios
Notas a los autores de llamadas
El contenedor inmediato de un objeto activo llama a este método para desactivar el objeto activo y descartar su estado de deshacer.Notas para los implementadores
Al volver desde IOleInPlaceObject::InPlaceDeactivate, el objeto descarta su estado de deshacer. La aplicación de objeto no debe apagarse inmediatamente después de esta llamada. En su lugar, debe esperar a que una llamada explícita a IOleObject::Close o para que el recuento de referencias del objeto alcance cero.Antes de desactivarlo, la aplicación de objeto debe dar al contenedor la oportunidad de volver a poner su interfaz de usuario en la ventana de marco mediante una llamada a IOleInPlaceSite::OnUIDeactivate.
Si la interfaz de usuario local sigue siendo visible durante la llamada a IOleInPlaceObject::InPlaceDeactivate, la aplicación de objeto debe llamar a su propio método IOleInPlaceObject::InPlaceDeactivate para ocultar la interfaz de usuario. La interfaz de usuario local se puede destruir opcionalmente durante las llamadas a IOleInPlaceObject::InPlaceDeactivate e IOleInPlaceObject::InPlaceDeactivate. Pero si la interfaz de usuario aún no se ha destruido cuando el contenedor llama a IOleObject::Close, se debe destruir durante la llamada a IOleObject::Close.
Durante la llamada a IOleObject::Close, el objeto debe comprobar si todavía está activo en su lugar. Si es así, debe llamar a IOleInPlaceObject::InPlaceDeactivate.
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
IOleInPlaceSite::OnInPlaceDeactivate