Valores retornados (recursos de acessibilidade do Windows)

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

Valores retornados comuns

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

Valor	Descrição
S_OK	O método foi bem-sucedido.
S_FALSE	O método foi bem-sucedido em parte. Isso acontece quando o método é bem-sucedido, mas as informações solicitadas não estão disponíveis. Por exemplo, a Acessibilidade Ativa da Microsoft retornará 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 do filho do objeto.
DISP_E_MEMBERNOTFOUND	O objeto não dá suporte à propriedade ou ação solicitada. Por exemplo, um botão de push retornará esse valor se você solicitar sua propriedade Value, pois ela 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 tem suporte nesse sistema operacional.
E_INVALIDARG	Um ou mais argumentos não eram válidos. Esse erro ocorre quando o chamador tenta identificar um objeto filho usando um identificador que o servidor não reconhece. Esse 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 pôde alocar a memória necessária para concluir uma operação crucial para seu sucesso.
E_FAIL	Ocorreu um erro desconhecido ou genérico.

 

Valores retornados adicionais

Veja a seguir valores retornados que os métodos IAccessible podem retornar. Esses valores retornados 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