Estrutura CDaoErrorInfo

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

Observação

O DAO tem suporte por meio do Office 2013. DAO 3.6 é a versão final e é considerada obsoleta.

Sintaxe

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 de DAO numérico. Confira o tópico "Erros de acesso a dados aprisionáveis" na Ajuda de DAO.

m_strSource
O nome do objeto ou aplicativo gerou o erro originalmente. A propriedade Source especifica uma expressão de cadeia de caracteres que representa o objeto que originalmente gerou o erro; a expressão costuma ser o nome de classe do objeto. Para detalhes, confira o tópico "Propriedade de origem" na Ajuda de DAO.

m_strDescription
Uma cadeia de caracteres descritiva associada a um erro. Para detalhes, confira o tópico "Propriedade de Descrição" na Ajuda do DAO.

m_strHelpFile
Um caminho totalmente qualificado para um arquivo de Ajuda do Microsoft Windows. Para detalhes, confira o tópico "HelpContext, HelpFile Properties" na Ajuda do DAO.

m_lHelpContext
Uma ID de contexto para um tópico em um arquivo de Ajuda do Microsoft Windows. Para detalhes, confira o tópico "HelpContext, HelpFile Properties" na Ajuda do DAO.

Comentários

O MFC não encapsula objetos de erro DAO em uma classe. Em vez disso, a classe CDaoException fornece uma interface para acessar a coleção Errors contida no objeto DBEngine DAO, o objeto que também contém todos os workspaces. Quando uma operação MFC DAO gera um objeto CDaoException que você captura, o MFC preenche uma estrutura CDaoErrorInfo e a armazena no membro m_pErrorInfo do objeto de exceção. (Se você optar por chamar o DAO diretamente, deverá chamar a função de membro GetErrorInfo do objeto de exceção para preencher m_pErrorInfo.)

Para mais informações sobre como lidar com erros de DAO, confira o artigo Exceções: Exceções de Banco de Dados. Para informações relacionadas, confira o tópico "Objeto de Erro" na Ajuda do DAO.

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

Requisitos

Cabeçalho: afxdao.h

Confira também

Estruturas, estilos, retornos de chamada e mapas de mensagem
Classe CDaoException