Partilhar via

Valores de retorno (recursos de acessibilidade do Windows)

Este tópico descreve os valores de retorno mais comuns e outros valores de retorno que você pode ver com menos frequência.

Valores de retorno comuns

Os métodos IAccessible retornam um dos seguintes valores, definidos em winerror.h, ou outro código de erro padrão COM (Component Object Model):

Valor Descrição
S_OK O método foi bem-sucedido.
S_FALSE O método teve sucesso em parte. Isso acontece quando o método é bem-sucedido, mas as informações solicitadas não estão disponíveis. Por exemplo, o Microsoft Ative Accessibility retorna S_FALSE se você chamar IAccessible::accHitTest para recuperar um objeto filho em um determinado ponto e o ponto especificado não estiver dentro do objeto ou filho do objeto.
DISP_E_MEMBERNOTFOUND O objeto não suporta a propriedade ou ação solicitada. Por exemplo, um botão retorna esse valor se você solicitar sua propriedade Value, porque ele não tem uma propriedade Value.
E_NOTIMPL O método não está implementado. Esse valor ocorre quando um cliente chama um método que ainda não é suportado nesse sistema operacional.
E_INVALIDARG Um ou mais argumentos não eram válidos. Este erro ocorre quando o chamador tenta identificar um objeto filho usando um identificador que o servidor não reconhece. Este erro também resulta quando um cliente tenta identificar um objeto filho dentro de um objeto que não tem filhos.
E_OUTOFMEMORY O método não conseguiu alocar a memória necessária para concluir uma operação crucial para o seu sucesso.
E_FAIL Ocorreu um erro desconhecido ou genérico.

 

Valores de retorno adicionais

A seguir estão os valores de retorno que IAccessible métodos podem retornar. Esses valores de retorno não são tão comuns quanto os anteriores, mas você deve estar ciente deles.

Valor Descrição
E_ACCESSDENIED Isso é retornado quando você chama get_accValue para obter o valor de um controle de senha.
DISP_E_EXCEPTION
CO_E_OBJNOTCONNECTED

 

 

 

  • Last updated on