Passer au contenu principal
Toutes les méthodes et propriétés d’interface d’ABBYY FineReader Engine renvoient une valeur de type HRESULT. HRESULT (« result handle ») permet de renvoyer des valeurs de succès, d’avertissement et d’erreur. En réalité, les HRESULT ne sont des handles de rien du tout ; ce sont simplement des valeurs sur 32 bits dans lesquelles plusieurs champs sont codés. Un résultat nul indique une réussite, et un résultat non nul indique un échec. Si un appel de méthode ou de propriété échoue, la méthode ou la propriété renvoie un code HRESULT indiquant l’échec. En outre, une description plus détaillée de l’erreur est fournie via l’interface IErrorInfo.
Pour Windows : veuillez consulter la documentation COM pour une description détaillée de la gestion des erreurs.
  • C#. (Windows uniquement) Les wrappers générés automatiquement pour les interfaces COM détectent les erreurs et les convertissent en exceptions standard. Encadrez une séquence de méthodes ABBYY FineReader Engine avec les instructions :
try
{
    ...
}
catch( Exception e )
{
    ...
}
  • C++ avec prise en charge COM native (Windows). La technologie de prise en charge COM native convertit les codes HRESULT des fonctions d’interface en exceptions d’un type spécial (_com_error) et utilise automatiquement les informations de IErrorInfo. Ainsi, une séquence de méthodes FineReader Engine peut être encadrée par les instructions :
try {
    ...
}
catch (_com_error& e) {
    ...
}
En général, la gestion des erreurs avec la prise en charge COM native s’effectue de la même manière que dans tout code C++ standard utilisant des fonctions susceptibles de lever des exceptions.
  • Raw C++ / C++. Les méthodes et propriétés de l’interface FineReader Engine ne peuvent pas lever d’exceptions, mais renvoient des HRESULT. Les principaux moyens de traiter ces codes de retour sont les macros SUCCEEDED et FAILED. Elles évaluent la valeur HRESULT et permettent d’en déduire le résultat de l’opération — succès ou échec. Pour obtenir un pointeur vers l’interface de l’objet IErrorInfo, utilisez les fonctions d’API suivantes :
    • GetErrorInfo pour Windows
    • GetFREngineErrorInfo pour Linux et macOS :
wchar_t* GetErrorMessage() {
   IErrorInfo* errorInfo;
   if( GetFREngineErrorInfo( 0, &errorInfo ) == S_OK && errorInfo != 0 ) {
      // Récupérer la description de l'erreur 
      wchar_t* description;
      errorInfo->GetDescription( &description );
      errorInfo->Release();
      return description;
   } else {
      return L"Unknown error";
   }
}
  • Java (Linux et Windows uniquement). Consultez Using ABBYY FineReader Engine in Java pour obtenir des conseils sur la gestion des erreurs en Java.
  • Visual Basic (Windows uniquement). Les utilisateurs de Visual Basic peuvent accéder au code HRESULT via la propriété Number de l’objet Err. Les autres attributs de l’objet Err sont initialisés à partir des informations de IErrorInfo. La gestion des erreurs s’effectue ici à l’aide de l’instruction On Error. Si vous n’utilisez l’instruction On Error Resume Next nulle part dans votre code, toute erreur d’exécution peut entraîner l’affichage d’un message d’erreur issu de IErrorInfo et l’arrêt de l’exécution du code.

​
Voir aussi

Codes de retour standard