Valeurs de retour (fonctionnalités d’accessibilité Windows)

  • Article

Cette rubrique décrit les valeurs de retour les plus courantes et d’autres valeurs de retour que vous pouvez voir moins fréquemment.

Valeurs de retour courantes

Les méthodes IAccessible retournent l’une des valeurs suivantes, définies dans winerror.h, ou un autre code d’erreur COM (Component Object Model) standard :

Valeur Description
S_OK S_OK
S_FALSE La méthode a réussi en partie. Cela se produit lorsque la méthode réussit, mais que les informations demandées ne sont pas disponibles. Par exemple, Microsoft Active Accessibility retourne S_FALSE si vous appelez IAccessible::accHitTest pour récupérer un objet enfant à un point donné, et que le point spécifié ne se trouve pas dans l’objet ou l’enfant de l’objet.
DISP_E_MEMBERNOTFOUND L’objet ne prend pas en charge la propriété ou l’action demandée. Par exemple, un bouton push retourne cette valeur si vous demandez sa propriété Value, car elle n’a pas de propriété Value.
E_NOTIMPL Cette méthode n'est pas implémentée. Cette valeur se produit lorsqu’un client appelle une méthode qui n’est pas encore prise en charge dans ce système d’exploitation.
E_INVALIDARG Un ou plusieurs arguments n’étaient pas valides. Cette erreur se produit lorsque l’appelant tente d’identifier un objet enfant à l’aide d’un identificateur que le serveur ne reconnaît pas. Cette erreur se produit également lorsqu’un client tente d’identifier un objet enfant dans un objet qui n’a pas d’enfants.
E_OUTOFMEMORY La méthode n’a pas pu allouer la mémoire nécessaire à l’exécution d’une opération cruciale pour sa réussite.
E_FAIL Une erreur inconnue ou générique s’est produite.

 

Valeurs de retour supplémentaires

Voici les valeurs de retour que les méthodes IAccessible peuvent retourner. Ces valeurs de retour ne sont pas aussi courantes que les précédentes, mais vous devez les connaître.

Valeur Description
E_ACCESSDENIED Cette valeur est retournée lorsque vous appelez get_accValue pour obtenir la valeur d’un contrôle de mot de passe.
DISP_E_EXCEPTION
CO_E_OBJNOTCONNECTED