Errori del motore di archiviazione estendibile

  • Articolo

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 Extensible Storage Engine Error Codes .For a list of the error flags that are defined for this API, see Extensible Storage Engine Error Codes.

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. È quindi possibile usare il valore di errore specifico 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 operazione riuscita e un valore minore di zero deve essere interpretato come un errore. Nessun altro criterio 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 dettagli sugli errori. Il livello di registrazione può essere controllato dai 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