Partilhar via


Estrutura CDaoErrorInfo

Observação

A biblioteca Microsoft Foundation Classes (MFC) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

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

Observação

DAO é suportado através do Office 2013. O DAO 3.6 é a versão final, e é considerado obsoleto.

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 numérico de erro DAO. Veja o tópico "Erros de Acesso a Dados Atrapáveis" na Ajuda do DAO.

m_strSource
O nome do objeto ou aplicação que originalmente gerou o erro. A propriedade Source especifica uma expressão de cadeia que representa o objeto que originalmente gerou o erro; a expressão é geralmente o nome da classe do objeto. Para detalhes, consulte o tópico "Propriedade Fonte" na Ajuda DAO.

m_strDescription
Uma cadeia descritiva associada a um erro. Para mais detalhes, consulte o tópico "Descrição de Propriedade" no DAO Help.

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

m_lHelpContext
Um ID de contexto para um tema num ficheiro de Ajuda do Microsoft Windows. Para detalhes, consulte o tópico "HelpContext, HelpFile Properties" na Ajuda DAO.

Observações

O MFC não encapsula objetos de erro DAO numa classe. Em vez disso, a classe CDaoException fornece uma interface para aceder à coleção de Erros contida no objeto DAO DBEngine , o objeto que também contém todos os espaços de trabalho. Quando uma operação DAO MFC lança um CDaoException objeto que apanhas, o MFC preenche uma CDaoErrorInfo estrutura e armazena-a no membro m_pErrorInfo do objeto de exceção. (Se optar por chamar diretamente o DAO, deve chamar a função membro GetErrorInfo do objeto excecional para preencher m_pErrorInfo.)

Para mais informações sobre o tratamento de erros de DAO, consulte o artigo Exceções: Exceções à Base de Dados. Para informações relacionadas, consulte o tópico "Objeto de Erro" na Ajuda do DAO.

A informação recuperada pela função membro CDaoException::GetErrorInfo é armazenada numa CDaoErrorInfo estrutura. Examine o m_pErrorInfo membro de dados de um CDaoException objeto que apanha num gestor de exceções, ou chame GetErrorInfo a partir de um CDaoException objeto que crie explicitamente para verificar erros que possam ter ocorrido durante uma chamada direta às interfaces DAO. CDaoErrorInfo também define uma Dump função membro em builds de depuração. Podes usar Dump para despejar o conteúdo de um CDaoErrorInfo objeto.

Requerimentos

Cabeçalho:afxdao.h

Consulte também

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