Compartilhar via

macro TAPIERROR_FORMATMESSAGE (tapi.h)

  • Artigo

A macro TAPIERROR_FORMATMESSAGE gera um identificador para códigos de erro TAPI padrão que podem ser usados na função FormatMessage .

Sintaxe

void TAPIERROR_FORMATMESSAGE(
   __ErrCode__
);

Parâmetros

__ErrCode__

Valor retornado

Nenhum

Comentários

Esse mecanismo deve ser usado apenas para exibir informações sobre erros para os quais o aplicativo não tem nenhum método de recuperação definido (ou seja, erros inesperados ou internos). Na maioria dos casos (ao contrário do exemplo simplificado a seguir), é desejável incluir texto adicional informando ao usuário sobre as ações que o aplicativo executa (ou o usuário deve tomar) como resultado do erro sem tratamento.

Se o aplicativo receber um resultado de erro de qualquer função TAPI, o valor de erro poderá ser passado para a macro TAPIERROR_FORMATMESSAGE , o que gera o identificador de mensagem a ser passado para FormatMessage.

Exemplos

O exemplo a seguir usa FormatMessage para produzir uma cadeia de caracteres de erro que corresponde a um código de erro TAPI.

lResult = lineClose(hLine);

if (lResult < 0)
{
    FormatMessage(FORMAT_MESSAGE_FROM_HMODULE,
                  (LPCVOID)GetModuleHandle("TAPIUI.DLL"),
                  TAPIERROR_FORMATMESSAGE(lResult),
                  0,
                  (LPTSTR)pBuf,
                  BUFSIZE,
                  NULL);
    MessageBox(hWnd,pBuf,"TAPI ERROR",MB_OK);
}

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho tapi.h