Método IOleControl::OnAmbientPropertyChange (ocidl.h)

Informa a um controle que uma ou mais das propriedades de ambiente do contêiner foram alteradas.

Sintaxe

HRESULT OnAmbientPropertyChange(
  [in] DISPID dispID
);

Parâmetros

[in] dispID

O identificador de expedição da propriedade ambiente que foi alterada. Se esse parâmetro for DISPID_UNKNOWN, ele indicará que várias propriedades foram alteradas. Nesse caso, o controle deve marcar todas as propriedades de ambiente de interesse para obter seus valores atuais.

Retornar valor

Esse método retorna S_OK em todos os casos.

Comentários

Observações aos implementadores

S_OK é retornado em todos os casos, mesmo quando o controle não dá suporte a propriedades ambiente ou ocorreu alguma outra falha. O chamador que envia a notificação não pode tentar usar um código de erro (como E_NOTIMPL) para determinar se deve enviar a notificação no futuro. Essa semântica não faz parte dessa interface.

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	ocidl.h

Confira também

Iolecontrol