Método IOleInPlaceSite::OnInPlaceActivate (oleidl.h)

Notifica o contêiner de que um de seus objetos está sendo ativado no local.

Sintaxe

HRESULT OnInPlaceActivate();

Valor retornado

Esse método retornará S_OK se o contêiner permitir a ativação in-loco. Outros valores retornados possíveis incluem o seguinte.

Código de retorno	Descrição
E_UNEXPECTED	Ocorreu um erro inesperado.

Comentários

Anotações aos Chamadores

OnInPlaceActivate é chamado pelo objeto inserido ativo quando ele é ativado in-loco pela primeira vez. O contêiner deve observar que o objeto está se tornando ativo.

Observações aos implementadores

Um contêiner que dá suporte à vinculação a objetos inseridos deve gerenciar corretamente a execução de seus objetos in-loco quando eles estiverem inativos na interface do usuário e em execução no estado oculto. Para reativar o objeto in-loco rapidamente, um contêiner não deve chamar IOleObject::Close até que o método IOleInPlaceSite::D eactivateAndUndo do contêiner seja chamado. Para ajudar a proteger contra o objeto que está sendo deixado em um estado instável se um cliente de vinculação for atualizado silenciosamente, o contêiner deverá chamar OleLockRunning para bloquear o objeto no estado em execução. Isso impede que o objeto in-loco oculto seja desligado antes que ele possa ser salvo em seu contêiner.

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

Ioleinplacesite