TAPIERROR_FORMATMESSAGE macro (tapi.h)

La macro TAPIERROR_FORMATMESSAGE génère un identificateur pour les codes d’erreur TAPI standard qui peuvent être utilisés dans la fonction FormatMessage .

Syntaxe

void TAPIERROR_FORMATMESSAGE(
  __ErrCode__
);

Paramètres

__ErrCode__

Valeur de retour

None

Remarques

Ce mécanisme doit être utilisé uniquement pour afficher des informations sur les erreurs pour lesquelles l’application n’a pas de méthode de récupération définie (c’est-à-dire des erreurs inattendues ou internes). Dans la plupart des cas (contrairement à l’exemple simplifié suivant), il est souhaitable d’inclure un texte supplémentaire informant l’utilisateur des actions que l’application effectue (ou que l’utilisateur doit effectuer) à la suite de l’erreur non gérée.

Si l’application obtient un résultat d’erreur à partir d’une fonction TAPI, la valeur d’erreur peut être passée à la macro TAPIERROR_FORMATMESSAGE , qui génère l’identificateur de message à passer à FormatMessage.

Exemples

L’exemple suivant utilise FormatMessage pour générer une chaîne d’erreur qui correspond à un code d’erreur 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);
}

Configuration requise