通过

TAPIERROR_FORMATMESSAGE宏 (tapi.h)

  • 项目

TAPIERROR_FORMATMESSAGE宏为可在 FormatMessage 函数中使用的标准 TAPI 错误代码生成标识符。

语法

void TAPIERROR_FORMATMESSAGE(
   __ErrCode__
);

参数

__ErrCode__

返回值

无

备注

此机制应仅用于显示有关应用程序没有定义恢复方法的错误的信息， () 意外错误或内部错误。 在大多数情况下， (与下面的简化示例) 不同，最好包含其他文本，告知用户应用程序 (执行的操作，或者用户应因未经处理的错误而采取) 。

如果应用程序从任何 TAPI 函数获取错误结果，则可以将错误值传递给 TAPIERROR_FORMATMESSAGE 宏，该宏生成要传递给 FormatMessage 的消息标识符。

示例

以下示例使用 FormatMessage 生成对应于 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);
}

要求

要求 值
目标平台 Windows
标头 tapi.h