TAPIERROR_FORMATMESSAGE macro (tapi.h)

La macro TAPIERROR_FORMATMESSAGE genera un identificador para los códigos de error TAPI estándar que se pueden usar en la función FormatMessage .

Sintaxis

void TAPIERROR_FORMATMESSAGE(
   __ErrCode__
);

Parámetros

__ErrCode__

Valor devuelto

None

Observaciones

Este mecanismo solo se debe usar para mostrar información sobre los errores para los que la aplicación no tiene ningún método definido de recuperación (es decir, errores inesperados o internos). En la mayoría de los casos (a diferencia del siguiente ejemplo simplificado), es conveniente incluir texto adicional que informe al usuario de las acciones que realiza la aplicación (o el usuario debe realizar) como resultado del error no controlado.

Si la aplicación obtiene un resultado de error de cualquier función TAPI, el valor de error se puede pasar a la macro TAPIERROR_FORMATMESSAGE , que genera el identificador de mensaje que se pasará a FormatMessage.

Ejemplos

En el ejemplo siguiente se usa FormatMessage para generar una cadena de error que corresponde a un código de error 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	Value
Plataforma de destino	Windows
Encabezado	tapi.h