확장 가능한 스토리지 엔진 오류

  • 아티클

적용 대상: Windows | Windows Server

확장 가능한 스토리지 엔진 오류

ESE(Extensible Storage Engine) API에서 반환할 수 있는 모든 오류는 JET_ERR 데이터 형식으로 정의됩니다. 이 API에 대해 정의된 오류 플래그 목록은 확장 가능한 스토리지 엔진 오류 코드를 참조하세요.

ESE API 설명서 전체에서 가장 중요한 오류만 문서화됩니다. 이러한 오류는 일반적으로 API 사용 오류 또는 매우 중요한 오류 조건을 나타냅니다. 이러한 ESE API 중 하나는 각 API에 대해 문서화되지 않은 다른 오류를 반환할 수도 있습니다. 이러한 경우 호출자는 API에서 반환하는 다른 오류와 마찬가지로 단순히 오류를 처리해야 합니다. 그런 다음 추적과 같은 진단 목적으로 특정 오류 값을 사용할 수 있습니다.

일반적으로 0보다 큰 값은 경고로 해석되고, 0 값은 성공으로 해석되어야 하며, 0보다 작은 값은 오류로 해석되어야 합니다. 이러한 값의 다른 패턴(예: 값 범위)은 애플리케이션에서 사용해서는 안 됩니다.

ESE에서 좀 더 심각한 오류가 발생하면 오류에 대한 세부 정보가 포함된 이벤트 로그 항목을 만듭니다. 로깅 수준은 이벤트 로그 매개 변수를 통해 제어할 수 있습니다.

일부 애플리케이션에는 JET_ERR를 HRESULT로 반환하는 기능이 필요합니다. 다음 C++ 예제에서는 해당 변환을 만드는 방법을 보여줍니다.

    #ifndef FACILITY_JET_ERR
    #define FACILITY_JET_ERR 0xE5E
    #endif
    #ifndef HRESULT_FROM_JET_ERR
    #define HRESULT_FROM_JET_ERR( __err )
    (
      ( __err ) == JET_errSuccess ?
      S_OK :
      (
        ( __err ) == JET_errOutOfMemory ?
        E_OUTOFMEMORY :
        MAKE_HRESULT
        (
          (
            ( __err ) < 0 ?
            SEVERITY_ERROR :
            SEVERITY_SUCCESS
          ),
          FACILITY_JET_ERR,
          (
            ( __err ) < 0 ?
            -( __err ) :
            ( __err )
          )
          & 0xFFFF
        )
      )
    )
    
    #endif

오류 처리를 위해 시스템 매개 변수를 구성하는 방법에 대한 자세한 내용은 오류 처리 매개 변수를 참조하세요.

참고 항목

매개 변수 처리 오류

확장 가능한 스토리지 엔진 오류 코드

JET_ERR