Erros extensíveis do mecanismo de armazenamento

  • Artigo

Aplica-se a: Windows | Windows Server

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 Códigos de erro extensíveis do mecanismo de armazenamento.

Em toda a documentação da API do ESE, somente 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 como faria com qualquer outro erro retornado pela API. Em seguida, o valor de erro específico pode ser usado para fins de diagnóstico, como rastreamento.

Em geral, um valor maior que zero deve ser interpretado como um aviso, um valor igual a 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 registro em log pode ser controlado por parâmetros de log de eventos.

Alguns aplicativos exigem a capacidade de retornar JET_ERRs como HRESULTs. O exemplo do 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 erros

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

JET_ERR