макрос TAPIERROR_FORMATMESSAGE (tapi.h)

Статья
03/05/2024

Макрос TAPIERROR_FORMATMESSAGE создает идентификатор для стандартных кодов ошибок TAPI, которые можно использовать в функции FormatMessage .

Синтаксис

void TAPIERROR_FORMATMESSAGE(
   __ErrCode__
);

Параметры

__ErrCode__

Возвращаемое значение

None

Remarks

Этот механизм следует использовать только для отображения сведений об ошибках, для которых приложение не имеет определенного метода восстановления (т. е. непредвиденных или внутренних ошибок). В большинстве случаев (в отличие от приведенного ниже упрощенного примера) желательно включить дополнительный текст, информирующий пользователя о действиях, которые приложение выполняет (или должен предпринять пользователь) в результате необработанной ошибки.

Если приложение получает результат ошибки от какой-либо функции 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
Header	tapi.h

Поделиться через