WIN32OLERuntimeError

WIN32OLERuntimeError

OLE 처리가 실패했을 때 발생하는 예외예요.

obj = WIN32OLE.new("NonExistProgID")

이 코드는 다음 예외를 발생시켜요:

WIN32OLERuntimeError: unknown OLE server: `NonExistProgID'
    HRESULT error code:0x800401f3
      Invalid class string

출처: Ruby 3.3 API

본문

WIN32OLERuntimeError는 OLE Automation 호출이 실패할 때 발생하는 일반적인 런타임 예외예요. 위 예시처럼 존재하지 않는 ProgID로 WIN32OLE.new를 호출하면, 예외 메시지에 원인과 HRESULT 오류 코드가 함께 표시돼요. 이 예외는 OLE 서버 생성, 메서드 호출 등 다양한 상황에서 던져질 수 있어요.