Sdílet prostřednictvím

Chyby rozšiřitelného modulu úložiště

  • Článek

platí pro: Windows | Windows Server

Chyby rozšiřitelného modulu úložiště

Všechny možné chyby vrácené rozhraním ESE (Extensible Storage Engine) API jsou definovány datovým typem JET_ERR. Seznam příznaků chyb definovaných pro toto rozhraní API najdete v tématu kódy chyb rozšiřitelného modulu úložiště.

V dokumentaci k rozhraní ESE API jsou zdokumentované pouze nejdůležitější chyby. Tyto chyby obvykle představují chyby využití rozhraní API nebo velmi důležité chybové stavy. Mějte na paměti, že některá z těchto rozhraní API ESE může také vracet další chyby, které nejsou zdokumentované pro každé rozhraní API. V těchto případech by volající měl chybu jednoduše zpracovat stejně jako jakoukoli jinou chybu vrácenou rozhraním API. Konkrétní chybovou hodnotu pak můžete použít pro diagnostické účely, jako je trasování.

Obecně platí, že hodnota větší než nula by se měla interpretovat jako upozornění, hodnota nuly by se měla interpretovat jako úspěch a hodnota, která je menší než nula, by se měla interpretovat jako chyba. Aplikace by neměla spoléhat na žádné jiné vzory v těchto hodnotách (například rozsahy hodnot).

Když ESE narazí na některé z vážnějších chyb, vytvoří položku protokolu událostí, která obsahuje podrobnosti o chybách. Úroveň protokolování lze řídit parametry protokolu událostí.

Některé aplikace vyžadují schopnost vrátit JET_ERRjako HRESULT. Následující příklad jazyka C++ ukazuje, jak provést převod:

    #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

Informace o konfiguraci systémových parametrů pro zpracování chyb naleznete v tématu Parametry zpracování chyb.

Viz také

parametry zpracování chyb

kódy chyb rozšiřitelného modulu úložiště

JET_ERR