CException::GetErrorMessage

virtual BOOL GetErrorMessage (LPTSTR lpszError, UINT nMaxError, PUINT pnHelpContext = NULL);

Valor de retorno

Diferente de zero se a função for bem-sucedida; caso contrário 0 se nenhum erro de mensagem de texto está disponível.

Parâmetros

lpszError

Um ponteiro para um buffer que receberá uma mensagem de erro.

nMaxError

O número máximo de caracteres que o buffer pode conter, incluindo o terminador Nulo.

pnHelpContext

O endereço de um UINT que receberá o identificação de contexto de ajuda. Se NULL, nenhuma identificação será retornada.

Observações

Chame essa função de membro para fornecer texto sobre um erro que ocorreu. Por exemplo, chamar GetErrorMessage para recuperar uma Cadeia de caracteres descrevendo o erro que causou MFC lançar um CFileException durante a gravação de um objeto de CFile.

Observação GetErrorMessage &não irá copiar mais do que nMaxError -1 caracteres para o buffer, e ele sempre irá adicionar um null à direita para acabar com a string.nbsp; Se a reserva for muito pequena, a mensagem de erro pode ser truncada.

Exemplo

Aqui está um exemplo do uso de CException::GetErrorMessage.

   CFile fileInput;
   CFileException ex;

/ / tenta abrir um arquivo para leitura.
   / / O arquivo irá certamente não
   / / existe porque existem demasiados explícita
   / / diretórios no nome.

/ / se a chamada Open () falhar, será ex
   / / inicializada com exceção
   / / information.nbsp; a chamada para ex.GetErrorMessage()
   / / irá recuperar uma mensagem apropriada que descrevem
   / / o erro e nós vamos adicionar nosso próprio texto
   / / para certificar-se de que o usuário é perfeitamente certo o que
   / / deu errado.
   
   se (! fileInput.Open ("\\Too\\Many\\Bad\\Dirs.DAT", CFile:: modeRead & ex))
   {
      TCHAR szCause [255];
      CString strFormatted;

ex.GetErrorMessage (szCause, 255);

/ / (na vida real, é provavelmente mais
      / / apropriado ler isto de
      / / um recurso de Cadeia de caracteres, por isso seria fácil de
      / / Localizar)

strFormatted =  t ("O arquivo de dados não pôde ser aberto por causa do erro:");
      strFormatted + = szCause;

AfxMessageBox(strFormatted);
   }
   outra pessoa
   {
      / / o arquivo foi aberto, então, fazer qualquer trabalho
      / / com fileInput
      / / Nós estávamos planejando...
      // :

fileInput.Close();
   }

Visão geral de CException |nbsp; Membros de classe | Gráfico de hierarquia

Co&nsulte tambémnbsp;CException::ReportError