Método IOleInPlaceObject::InPlaceDeactivate (oleidl.h)

Desativa um objeto in-loco ativo e descarta o estado de desfazer do objeto.

Sintaxe

HRESULT InPlaceDeactivate();

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
E_UNEXPECTED	Erro inesperado.

Comentários

Anotações aos Chamadores

Esse método é chamado pelo contêiner imediato de um objeto ativo para desativar o objeto ativo e descartar seu estado de desfazer.

Observações aos implementadores

No retorno de IOleInPlaceObject::InPlaceDeactivate, o objeto descarta seu estado de desfazer. O aplicativo de objeto não deve ser desligado imediatamente após essa chamada. Em vez disso, ele deve aguardar uma chamada explícita para IOleObject::Close ou para que a contagem de referência do objeto atinja zero.

Antes de desativar, o aplicativo objeto deve dar ao contêiner a chance de colocar sua interface do usuário novamente na janela de quadro chamando IOleInPlaceSite::OnUIDeactivate.

Se a interface do usuário in-loco ainda estiver visível durante a chamada para IOleInPlaceObject::InPlaceDeactivate, o aplicativo de objeto deverá chamar seu próprio método IOleInPlaceObject::InPlaceDeactivate para ocultar a interface do usuário. Opcionalmente, a interface do usuário in-loco pode ser destruída durante chamadas para IOleInPlaceObject::InPlaceDeactivate e IOleInPlaceObject::InPlaceDeactivate. Mas se a interface do usuário ainda não tiver sido destruída quando o contêiner chamar IOleObject::Close, ela deverá ser destruída durante a chamada para IOleObject::Close.

Durante a chamada para IOleObject::Close, o objeto deve marcar para ver se ele ainda está ativo no local. Nesse caso, ele deve chamar IOleInPlaceObject::InPlaceDeactivate.

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

Ioleinplaceobject

IOleInPlaceSite::OnInPlaceDeactivate

IOleInPlaceSite::OnUIDeactivate

IOleObject::Close