Generazione di eccezioni software
Alcuni degli errori di programma più comuni non sono contrassegnati come eccezioni dal sistema. Ad esempio, se si tenta di allocare un blocco di memoria ma non vi è memoria sufficiente, il runtime o la funzione API non genera un'eccezione ma restituisce un codice di errore.
Tuttavia, è possibile trattare eventuali condizioni come un'eccezione rilevando la condizione nel codice e quindi segnalandola utilizzando la chiamata alla funzione RaiseException. Contrassegnando gli errori in questo modo, è possibile offrire i vantaggi di gestione delle eccezioni strutturate a qualsiasi tipo di errore di runtime.
Per utilizzare la gestione delle eccezioni strutturata con errori:
Definire il proprio codice di eccezione per l'evento.
Chiamare RaiseException quando viene rilevato un problema.
Utilizzare i filtri per la gestione delle eccezioni per esegue il test del codice di eccezione definito.
Il file WINERROR.H mostra il formato per i codici di eccezione. Per assicurarsi di non definire un codice che sia in conflitto con il codice di eccezione esistente, impostare il terzo bit più significativo su 1. I quattro bit più significativi dovrebbe essere impostati come illustrato nella tabella seguente.
Bit |
Impostazione binaria consigliata |
Descrizione |
|---|---|---|
31-30 |
11 |
Questi due bit descrivono lo stato di base del codice: 11 = errore, 00 = esito positivo, 01 = messaggio informativo, 10 = avviso. |
29 |
1 |
Bit client. Impostare su 1 per i codici definiti dall'utente. |
28 |
0 |
Bit riservati. Lasciare impostato su 0. |
È possibile impostare i primi due bit su un'impostazione diversa dall'11 binario se si desidera, sebbene l'impostazione "errore" sia appropriata per la maggior parte delle eccezioni. È importante ricordare che è possibile impostare i bit 29 e 28 come illustrato nella tabella precedente.
Nel codice di errore risultante pertanto i quattro bit più elevati dovranno essere impostati sull'esadecimale E. Ad esempio, le seguenti definizioni definiscono i codici di eccezione che non entrino in conflitto con alcun codice di eccezione Windows. È possibile, tuttavia, che sia necessario verificare quali codici vengono utilizzati dalle DLL di terze parti.
#define STATUS_INSUFFICIENT_MEM 0xE0000001
#define STATUS_FILE_BAD_FORMAT 0xE0000002
Dopo aver definito un codice di eccezione, è possibile utilizzarlo per generare un'eccezione. Ad esempio, il codice seguente genera l'eccezione STATUS_INSUFFICIENT_MEM in risposta a un problema di allocazione della memoria:
lpstr = _malloc( nBufferSize );
if (lpstr == NULL)
RaiseException( STATUS_INSUFFICIENT_MEM, 0, 0, 0);
Se si desidera semplicemente generare un'eccezione, è possibile impostare gli ultimi tre parametri su 0. Gli ultimi tre parametri sono utili per comunicare le informazioni aggiuntive e impostare un contrassegno che impedisce ai gestori di proseguire l'esecuzione. Per ulteriori informazioni vedere la funzione RaiseException in Windows SDK.
Nei filtri di gestione delle eccezioni, è quindi possibile eseguire il test dei codici definiti. Di seguito è riportato un esempio.
__try {
...
}
__except (GetExceptionCode() == STATUS_INSUFFICIENT_MEM ||
GetExceptionCode() == STATUS_FILE_BAD_FORMAT )