macro TAPIERROR_FORMATMESSAGE (tapi.h)

Articolo
03/13/2024

La macro TAPIERROR_FORMATMESSAGE genera un identificatore per i codici di errore TAPI standard che possono essere usati nella funzione FormatMessage .

Sintassi

void TAPIERROR_FORMATMESSAGE(
   __ErrCode__
);

Parametri

__ErrCode__

Valore restituito

nessuno

Osservazioni

Questo meccanismo deve essere usato solo per visualizzare informazioni sugli errori per cui l'applicazione non ha alcun metodo definito di ripristino, ovvero errori imprevisti o interni. Nella maggior parte dei casi (a differenza dell'esempio semplificato seguente), è consigliabile includere testo aggiuntivo che informa l'utente delle azioni eseguite dall'applicazione (o l'utente deve eseguire) in seguito all'errore non gestito.

Se l'applicazione ottiene un risultato di errore da qualsiasi funzione TAPI, il valore di errore può essere passato alla macro TAPIERROR_FORMATMESSAGE , che genera l'identificatore del messaggio da passare a FormatMessage.

Esempio

Nell'esempio seguente viene usato FormatMessage per produrre una stringa di errore corrispondente a un codice di errore 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);
}

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	tapi.h

Condividi tramite