Utökningsbara fel i lagringsmotorn

gäller för: Windows | Windows Server

Utökningsbara fel i lagringsmotorn

Alla möjliga fel som returneras av API:et Extensible Storage Engine (ESE) definieras av JET_ERR datatypen. En lista över felflaggor som har definierats för det här API:et finns i Extensible Storage Engine Error Codes.

I ESE API-dokumentationen dokumenteras endast de viktigaste felen. Dessa fel representerar vanligtvis API-användningsfel eller mycket viktiga felvillkor. Tänk på att någon av dessa ESE-API:er också kan returnera andra fel som inte dokumenteras för varje API. I dessa fall bör anroparen helt enkelt hantera felet på samma sätt som andra fel som returneras av API:et. Det specifika felvärdet kan sedan användas för diagnostiska ändamål, till exempel spårning.

I allmänhet ska ett värde som är större än noll tolkas som en varning, ett värde på noll ska tolkas som lyckat och ett värde som är mindre än noll ska tolkas som ett fel. Inga andra mönster i dessa värden (till exempel intervall med värden) bör användas av ett program.

När ESE stöter på några av de allvarligare felen skapas en händelseloggpost som innehåller information om felen. Loggningsnivån kan styras av händelseloggparametrar.

Vissa program kräver möjligheten att returnera JET_ERRsom HRESULTs. I följande C++-exempel visas hur du gör konverteringen:

    #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

Information om hur du konfigurerar systemparametrar för felhantering finns i Felhanteringsparametrar.

Se även

felhanteringsparametrar

Utökningsbara felkoder för lagringsmotorn

JET_ERR