Fouten met uitbreidbare opslagengine

van toepassing op: Windows | Windows Server

Fouten met uitbreidbare opslagengine

Alle mogelijke fouten die worden geretourneerd door de ESE-API (Extensible Storage Engine) worden gedefinieerd door het JET_ERR gegevenstype. Zie Extensible Storage Engine-foutcodesvoor een lijst met foutvlagmen die zijn gedefinieerd voor deze API.

In de ESE API-documentatie worden alleen de belangrijkste fouten gedocumenteerd. Deze fouten vertegenwoordigen meestal API-gebruiksfouten of zeer belangrijke foutvoorwaarden. Houd er rekening mee dat een van deze ESE API's ook andere fouten kan retourneren die niet zijn gedocumenteerd voor elke API. In deze gevallen moet de aanroeper de fout gewoon afhandelen, net zoals elke andere fout die wordt geretourneerd door de API. De specifieke foutwaarde kan vervolgens worden gebruikt voor diagnostische doeleinden, zoals tracering.

Over het algemeen moet een waarde die groter is dan nul worden geïnterpreteerd als een waarschuwing, moet een waarde van nul worden geïnterpreteerd als geslaagd en een waarde die kleiner is dan nul moet worden geïnterpreteerd als een fout. Er moeten geen andere patronen in deze waarden (bijvoorbeeld bereiken van waarden) worden gebruikt door een toepassing.

Wanneer ESE een aantal van de ernstigere fouten tegenkomt, wordt er een vermelding in het gebeurtenislogboek gemaakt die details over de fouten bevat. Het niveau van logboekregistratie kan worden bepaald door parameters voor gebeurtenislogboeken.

Voor sommige toepassingen is de mogelijkheid nodig om JET_ERRals HRESULTs te retourneren. In het volgende C++-voorbeeld ziet u hoe u deze conversie kunt uitvoeren:

    #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

Zie Parameters voor foutafhandelingvoor meer informatie over het configureren van systeemparameters voor foutafhandeling.

Zie ook

parameters voor foutafhandeling

Foutcodes voor uitbreidbare opslagengines

JET_ERR