Compartilhar via


DoAction ControlEvent

O DoAction ControlEvent notifica o instalador para executar uma ação personalizada. Esse evento pode ser publicado por um controle PushButton, controle CheckBox ou um controle SelectionTree. Esse evento deve ser criado na tabela ControlEvent.

Observe que ações personalizadas iniciadas por um DoAction ControlEvent podem enviar uma mensagem com o método message, mas não podem enviar uma mensagem com msiProcessMessage. Em sistemas anteriores ao Windows Server 2003, as ações personalizadas iniciadas por um DoAction ControlEvent não podem enviar mensagens com MsiProcessMessage ou Message Method. Para obter mais informações, consulte Enviar Mensagens para o Windows Installer usando o MsiProcessMessage.

Esse ControlEvent requer que a interface do usuário seja executada no nível de de interface do usuário completo. Esse evento não funcionará com uma de interface do usuário reduzida ou de interface do usuário básica. Para obter mais informações, consulte níveis de interface do usuário.

Publicado por

Esse ControlEvent é publicado pelo instalador.

Argumento

Uma cadeia de caracteres, o nome da ação personalizada a ser executada.

Ação em Assinantes

Esse ControlEvent não executa uma ação nos assinantes.

Uso Típico

Um controle PushButton em uma caixa de diálogo está vinculado a esse evento na tabela ControlEvent para invocar uma ação personalizada.