TAPIERROR_FORMATMESSAGE makro (tapi.h)

Makro TAPIERROR_FORMATMESSAGE menghasilkan pengidentifikasi untuk kode kesalahan TAPI standar yang dapat digunakan dalam fungsi FormatMessage .

Sintaks

void TAPIERROR_FORMATMESSAGE(
  __ErrCode__
);

Parameter

__ErrCode__

Mengembalikan nilai

Tidak ada

Keterangan

Mekanisme ini harus digunakan hanya untuk menampilkan informasi tentang kesalahan yang aplikasinya tidak memiliki metode pemulihan yang ditentukan (yaitu, kesalahan tak terduga atau internal). Dalam kebanyakan kasus (tidak seperti contoh yang disederhanakan berikut), diinginkan untuk menyertakan teks tambahan yang memberi tahu pengguna tentang tindakan yang diambil aplikasi (atau yang harus diambil pengguna) sebagai akibat dari kesalahan yang tidak tertangani.

Jika aplikasi mendapatkan hasil kesalahan dari fungsi TAPI apa pun, nilai kesalahan dapat diteruskan ke makro TAPIERROR_FORMATMESSAGE , yang menghasilkan pengidentifikasi pesan untuk diteruskan ke FormatMessage.

Contoh

Contoh berikut menggunakan FormatMessage untuk menghasilkan string kesalahan yang sesuai dengan kode kesalahan 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);
}

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	tapi.h