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);
}

規格需求