Valores retornados (Windows recursos de acessibilidade)

Este tópico descreve os valores retornados mais comuns e outros valores retornados 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 do Modelo de Objeto de Componente (COM):

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, o Microsoft Active Accessibility 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, porque ela não tem uma propriedade Value.
E_NOTIMPL O método não é 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 de retorno 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