Metodo IDebugControl3::SetSystemErrorControl (dbgeng.h)

Articolo
02/06/2025

Il metodo SetSystemErrorControl imposta i valori del controllo per la gestione degli errori di sistema.

Sintassi

HRESULT SetSystemErrorControl(
  [in] ULONG OutputLevel,
  [in] ULONG BreakLevel
);

Parametri

[in] OutputLevel

Specifica il livello in cui gli errori di sistema vengono stampati nell'output del motore. Se il livello dell'errore di sistema è minore o uguale a OutputLevel, l'errore viene stampato nella console del debugger.

[in] BreakLevel

Specifica il livello in cui gli errori di sistema si interrompono nel debugger. Se il livello dell'errore di sistema è minore o uguale a BreakLevel, l'errore si interrompe nel debugger.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altri dettagli, vedere valori restituiti.

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo.

Osservazioni

Il livello di un errore di sistema può accettare uno dei tre valori seguenti, elencati dal più basso al più alto: SLE_ERROR, SLE_MINORERROR e SLE_WARNING. Questi valori sono definiti in Winuser.h.

Quando si verifica un errore di sistema, il motore chiama il metodo IDebugEventCallbacks::SystemError dei callback dell'evento. Se il livello è minore o uguale al parametro BreakLevel, l'errore verrà interrotto nel debugger. Se il livello è maggiore di BreakLevel, il motore procederà con l'esecuzione nella destinazione, come indicato dalle chiamate al metodo IDebugEventCallbacks::SystemError. Per altre informazioni su come il motore procede dopo un evento, vedere Monitoraggio eventi.