Compartilhar via


Estrutura CDaoErrorInfo

A estrutura de CDaoErrorInfo contém informações sobre um objeto de erro definida para objetos (DAO) de acesso a dados.

struct CDaoErrorInfo 
{ 
   long m_lErrorCode; 
   CString m_strSource; 
   CString m_strDescription; 
   CString m_strHelpFile; 
   long m_lHelpContext; 
};

Parâmetros

  • m_lErrorCode
    Um código de erro numérico de DAO. Consulte o tópico “erros de acesso a dados Trappable” na ajuda de DAO.

  • m_strSource
    O nome do objeto ou do aplicativo que originalmente gerou o erro. A propriedade da origem especifica uma expressão de cadeia de caracteres que representa o objeto que originalmente gerou o erro; a expressão é normalmente o nome da classe do objeto. Para obter detalhes, consulte o tópico “property origem” na ajuda de DAO.

  • m_strDescription
    Uma cadeia de caracteres descritiva associada com um erro. Para obter detalhes, consulte o tópico “propriedade description” na ajuda de DAO.

  • m_strHelpFile
    Um caminho totalmente qualificado para um arquivo de ajuda do Microsoft Windows. Para obter detalhes, consulte o tópico “HelpContext, propriedades HelpFile” na ajuda de DAO.

  • m_lHelpContext
    Um ID do contexto de um tópico em um arquivo de ajuda do Microsoft Windows. Para obter detalhes, consulte o tópico “HelpContext, propriedades HelpFile” na ajuda de DAO.

Comentários

O MFC não encapsula objetos de erro de DAO em uma classe. Em vez disso, a classe de CDaoException fornece uma interface para acessar a coleção de erros contidas no objeto de DBEngine , DAO o objeto que também contém todos os espaços de trabalho. Quando uma operação de MFC DAO gerar um objeto de CDaoException que você a captura, MFC preencha uma estrutura de CDaoErrorInfo e a armazena no membro de m_pErrorInfo do objeto de exceção. (Se você escolher para chamar diretamente DAO, você deve chamar a função de membro de GetErrorInfo do objeto de exceção você mesmo para preencher m_pErrorInfo.)

Para obter mais informações sobre como tratar erros de DAO, consulte o artigo Exceções: Exceções da base de dados. Para obter informações relacionadas, consulte o tópico “objeto erro” na ajuda de DAO.

As informações recuperadas pela função de membro de CDaoException::GetErrorInfo são armazenadas em uma estrutura de CDaoErrorInfo . Examine o membro de dados de m_pErrorInfo de um objeto de CDaoException que você capture em um manipulador de exceção, ou chame GetErrorInfo de um objeto de CDaoException que você criou explicitamente para verificar os erros que podem ter ocorrido durante uma chamada direta para DAO interfaces. CDaoErrorInfo também define uma função de membro de Dump em construções de depuração. Você pode usar para Dump despejar os conteúdos de um objeto de CDaoErrorInfo .

Requisitos

Header: afxdao.h

Consulte também

Referência

Classe CDaoException

Outros recursos

Estruturas, estilos, retornos de chamada e mapas de mensagem