메인 콘텐츠로 건너뛰기
모든 ABBYY FineReader Engine 인터페이스 메서드와 속성은 HRESULT 유형의 값을 반환합니다. HRESULT(“result handle”의 약자)는 성공, warning, 오류 값을 반환하는 방식입니다. HRESULT는 실제로 어떤 것에 대한 Handle도 아니며, 값 내부에 여러 field가 인코딩된 32비트 값일 뿐입니다. 결과가 0이면 성공을, 0이 아니면 실패를 의미합니다. 메서드 또는 속성 호출이 성공하지 못한 경우 해당 메서드 또는 속성은 실패를 나타내는 HRESULT 코드를 반환합니다. 또한 IErrorInfo 인터페이스를 통해 오류에 대한 보다 자세한 설명도 제공합니다.
Windows의 경우: 오류 처리에 대한 자세한 내용은 COM 설명서를 참조하세요.
  • C#. (Windows 전용) COM 인터페이스용으로 자동 생성된 래퍼는 오류를 감지해 표준 예외로 변환합니다. 일련의 ABBYY FineReader Engine 메서드 호출은 다음 문으로 묶으세요:
try
{
    ...
}
catch( Exception e )
{
    ...
}
  • Native COM support를 사용하는 C++(Windows). Native COM support 기술은 인터페이스 함수의 HRESULT 코드를 특수 유형(_com_error)의 예외로 변환하고, IErrorInfo의 정보도 자동으로 사용합니다. 따라서 일련의 FineReader Engine 메서드 호출은 다음 문으로 둘러쌀 수 있습니다:
try {
    ...
}
catch (_com_error& e) {
    ...
}
일반적으로 Native COM 지원의 오류 처리는 예외를 throw할 수 있는 함수를 사용하는 일반적인 C++ 코드의 표준 방식으로 수행할 수 있습니다.
  • Raw C++ / C++. FineReader Engine 인터페이스 메서드와 속성은 예외를 throw하지 않고 HRESULT를 반환합니다. 이러한 반환 코드를 처리하는 가장 중요한 수단은 SUCCEEDED 및 FAILED 매크로입니다. 이 매크로는 HRESULT 값을 검사하여 작업 결과가 성공인지 실패인지 판단합니다. IErrorInfo 객체의 인터페이스에 대한 포인터를 가져오려면 다음 API 함수를 사용합니다.
    • Windows용 GetErrorInfo
    • Linux 및 macOS용 GetFREngineErrorInfo:
wchar_t* GetErrorMessage() {
   IErrorInfo* errorInfo;
   if( GetFREngineErrorInfo( 0, &errorInfo ) == S_OK && errorInfo != 0 ) {
      // 오류 설명 가져오기 
      wchar_t* description;
      errorInfo->GetDescription( &description );
      errorInfo->Release();
      return description;
   } else {
      return L"Unknown error";
   }
}
  • Java(Linux 및 Windows만 해당). Java의 오류 처리에 대한 자세한 내용은 Using ABBYY FineReader Engine in Java를 참조하세요.
  • Visual Basic(Windows만 해당). Visual Basic 사용자는 Err 객체의 Number 속성을 통해 HRESULT 코드에 액세스할 수 있습니다. Err 객체의 다른 속성은 IErrorInfo의 정보로 초기화됩니다. 여기서 오류 처리는 On Error 문을 사용해 수행됩니다. 코드 어디에서도 On Error Resume Next 문을 사용하지 않으면, 발생하는 런타임 오류로 인해 IErrorInfo의 오류 메시지가 표시되고 코드 실행이 중지될 수 있습니다.

​
추가 참조

표준 반환 코드