Errori del motore di archiviazione estendibile

si applica a: Windows | Windows Server

Errori del motore di archiviazione estendibile

Tutti i possibili errori restituiti dall'API ESE (Extensible Storage Engine) sono definiti dal tipo di dati JET_ERR. Per un elenco dei flag di errore definiti per questa API, vedere codici di errore del motore di archiviazione estendibile.

Nella documentazione dell'API ESE sono documentati solo gli errori più importanti. Questi errori rappresentano in genere errori di utilizzo dell'API o condizioni di errore molto importanti. Tenere presente che una di queste API ESE può anche restituire altri errori non documentati per ogni API. In questi casi, il chiamante deve semplicemente gestire l'errore come qualsiasi altro errore restituito dall'API. Il valore di errore specifico può quindi essere usato per scopi diagnostici, ad esempio la traccia.

In generale, un valore maggiore di zero deve essere interpretato come avviso, un valore pari a zero deve essere interpretato come esito positivo e un valore minore di zero deve essere interpretato come un errore. Nessun altro modello in questi valori (ad esempio, intervalli di valori) deve essere basato su un'applicazione.

Quando ESE rileva alcuni degli errori più gravi, crea una voce del registro eventi che contiene informazioni dettagliate sugli errori. Il livello di registrazione può essere controllato da parametri del registro eventi.

Alcune applicazioni richiedono la possibilità di restituire JET_ERRcome HRESULT. L'esempio C++ seguente illustra come eseguire la conversione:

    #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

Per informazioni sulla configurazione dei parametri di sistema per la gestione degli errori, vedere parametri di gestione degli errori.

Vedere anche

parametri di gestione degli errori

codici di errore del motore di archiviazione estendibile

JET_ERR