Erreurs du moteur de stockage extensible

S’applique à : Windows | Windows Server

Erreurs du moteur de stockage extensible

Toutes les erreurs possibles retournées par l’API ESE (Extensible Storage Engine) sont définies par le type de données JET_ERR . Pour obtenir la liste des indicateurs d’erreur définis pour cette API, consultez Codes d’erreur du moteur de stockage extensible.

Dans la documentation de l’API ESE, seules les erreurs les plus importantes sont documentées. Ces erreurs représentent généralement des erreurs d’utilisation de l’API ou des conditions d’erreur très importantes. N’oubliez pas que l’une de ces API ESE peut également retourner d’autres erreurs qui ne sont pas documentées pour chaque API. Dans ce cas, l’appelant doit simplement gérer l’erreur comme il le ferait pour toute autre erreur retournée par l’API. La valeur d’erreur spécifique peut ensuite être utilisée à des fins de diagnostic, telles que le suivi.

En général, une valeur supérieure à zéro doit être interprétée comme un avertissement, une valeur de zéro doit être interprétée comme une réussite et une valeur inférieure à zéro doit être interprétée comme une erreur. Aucune autre modèle dans ces valeurs (par exemple, les plages de valeurs) ne doit être utilisé par une application.

Quand ESE rencontre certaines des erreurs les plus graves, il crée une entrée de journal des événements qui contient des détails sur les erreurs. Le niveau de journalisation peut être contrôlé par les paramètres du journal des événements.

Certaines applications nécessitent la possibilité de retourner des JET_ERRen tant que HRESULT. L’exemple C++ suivant montre comment effectuer cette conversion :

    #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

Pour plus d’informations sur la configuration des paramètres système pour la gestion des erreurs, consultez Paramètres de gestion des erreurs.

Voir aussi

Paramètres de gestion des erreurs

Codes d’erreur du moteur de stockage extensible

JET_ERR