TAPIERROR_FORMATMESSAGE Makro (tapi.h)

Artikel
03/02/2024

Das TAPIERROR_FORMATMESSAGE Makro generiert einen Bezeichner für standardmäßige TAPI-Fehlercodes, die in der FormatMessage-Funktion verwendet werden können.

Syntax

void TAPIERROR_FORMATMESSAGE(
   __ErrCode__
);

Parameter

__ErrCode__

Rückgabewert

Keine

Bemerkungen

Dieser Mechanismus sollte nur zum Anzeigen von Informationen zu Fehlern verwendet werden, für die die Anwendung keine definierte Wiederherstellungsmethode hat (d. b. unerwartete oder interne Fehler). In den meisten Fällen (im Gegensatz zum folgenden vereinfachten Beispiel) ist es wünschenswert, zusätzlichen Text einzuschließen, der den Benutzer über Aktionen informiert, die die Anwendung als Ergebnis des nicht behandelten Fehlers ausführt (oder den Benutzer ausführen sollte).

Wenn die Anwendung ein Fehlerergebnis von einer TAPI-Funktion erhält, kann der Fehlerwert an das makro TAPIERROR_FORMATMESSAGE übergeben werden, das den Nachrichtenbezeichner generiert, der an FormatMessage übergeben werden soll.

Beispiele

Im folgenden Beispiel wird FormatMessage verwendet, um eine Fehlerzeichenfolge zu erzeugen, die einem TAPI-Fehlercode entspricht.

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

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	tapi.h

Freigeben über