Método IUIAutomation::RemoveAutomationEventHandler (uiautomationclient.h)
Remove o manipulador de eventos Automação da Interface do Usuário especificado.
Sintaxe
HRESULT RemoveAutomationEventHandler(
[in] EVENTID eventId,
[in] IUIAutomationElement *element,
[in] IUIAutomationEventHandler *handler
);
Parâmetros
[in] eventId
Tipo: EVENTID
O identificador do evento que está sendo tratado. Para obter uma lista de IDs de evento, consulte Identificadores de eventos.
[in] element
Tipo: IUIAutomationElement*
Um ponteiro para o elemento Automação da Interface do Usuário que está tratando o evento.
[in] handler
Tipo: IUIAutomationEventHandler*
Um ponteiro para o método de manipulador que foi passado para IUIAutomation::AddAutomationEventHandler para o identificador de evento especificado e Automação da Interface do Usuário elemento.
Retornar valor
Tipo: HRESULT
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
Um cliente Automação da Interface do Usuário não deve usar vários threads para adicionar ou remover manipuladores de eventos. Um comportamento inesperado poderá resultar se um manipulador de eventos estiver sendo adicionado ou removido enquanto outro estiver sendo adicionado ou removido no mesmo processo de cliente.
É possível que um evento seja entregue a um manipulador de eventos depois que o manipulador tiver sido cancelado, se o evento for recebido simultaneamente com a solicitação para cancelar a assinatura do evento. A melhor prática é seguir o padrão COM (Component Object Model) e evitar destruir o objeto do manipulador de eventos até que sua contagem de referência tenha atingido zero. Destruir um manipulador de eventos imediatamente após a não assinatura de eventos pode resultar em uma violação de acesso se um evento for entregue com atraso.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista, Windows XP com SP3 e Atualização de Plataforma para Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 R2, Windows Server 2008 com SP2 e Atualização de Plataforma para Windows Server 2008, Windows Server 2003 com SP2 e Atualização de Plataforma para Windows Server 2008 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | uiautomationclient.h (inclua UIAutomation.h) |
Confira também
RemoveFocusChangedEventHandler