Erros extensíveis do mecanismo de Armazenamento

Aplica-se a: Windows | servidor Windows

Erros extensíveis do mecanismo de Armazenamento

Todos os erros possíveis retornados pela API do Mecanismo de Armazenamento Extensível (ESE) são definidos pelo tipo de dados JET_ERR. Para obter uma lista dos sinalizadores de erro definidos para essa API, consulte Extensible Armazenamento Códigos de Erro do Mecanismo.

Em toda a documentação da API do ESE, apenas os erros mais importantes são documentados. Esses erros normalmente representam erros de uso da API ou condições de erro muito importantes. Lembre-se de que qualquer uma dessas APIs do ESE também pode retornar outros erros que não estão documentados para cada API. Nesses casos, o chamador deve simplesmente lidar com o erro, pois eles fariam qualquer outro erro retornado pela API. O valor de erro específico pode então ser usado para fins de diagnóstico, como rastreamento.

Em geral, um valor maior que zero deve ser interpretado como um aviso, um valor zero deve ser interpretado como êxito e um valor menor que zero deve ser interpretado como um erro. Nenhum outro padrão nesses valores (por exemplo, intervalos de valores) deve ser confiado por um aplicativo.

Quando o ESE encontra alguns dos erros mais graves, ele cria uma entrada de log de eventos que contém detalhes sobre os erros. O nível de log pode ser controlado por parâmetros de log de eventos.

Alguns aplicativos exigem a capacidade de retornar JET_ERR como HRESULTs. O exemplo C++ a seguir mostra como fazer essa conversão:

    #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

Para obter informações sobre como configurar parâmetros do sistema para tratamento de erros, consulte Parâmetros de Tratamento de Erros.

Consulte Também

Parâmetros de tratamento de erro

Códigos de erro extensíveis do mecanismo de Armazenamento

JET_ERR