Funzione WerReportCreate (werapi.h)

Articolo
03/13/2024

Crea un report Segnalazione errori Windows (WER) che descrive un evento dell'applicazione.

Sintassi

HRESULT WerReportCreate(
  [in]           PCWSTR                  pwzEventType,
  [in]           WER_REPORT_TYPE         repType,
  [in, optional] PWER_REPORT_INFORMATION pReportInformation,
  [out]          HREPORT                 *phReportHandle
);

Parametri

[in] pwzEventType

Puntatore a una stringa Unicode che specifica il nome dell'evento.

[in] repType

Tipo di report. Questo parametro può essere uno dei valori seguenti dal tipo di enumerazione WER_REPORT_TYPE .

Valore	Significato
WerReportApplicationCrash 2	Errore che ha causato l'arresto dell'esecuzione dell'applicazione.
WerReportApplicationHang 3	Si è verificato un errore che ha causato l'arresto della risposta dell'applicazione.
WerReportInvalid 5	Errore che ha chiamato un ritorno non valido.
WerReportKernel 4	Si è verificato un errore nel kernel.
WerReportCritical 1	Si è verificato un errore critico, ad esempio un arresto anomalo o non una risposta. Per impostazione predefinita, i processi che verificano un errore critico vengono terminati o riavviati.
WerReportNonCritical 0	Si è verificato un errore che non è critico. Questo tipo di report non mostra alcuna interfaccia utente; il report viene accodato in modo invisibile all'utente. Può quindi essere inviato in modo invisibile al server in background se è disponibile un consenso utente adeguato.

[in, optional] pReportInformation

Puntatore a una struttura WER_REPORT_INFORMATION che specifica informazioni per il report.

[out] phReportHandle

Handle per il report. Se la funzione ha esito negativo, questo handle è NULL.

Valore restituito

Questa funzione restituisce S_OK in caso di esito positivo o in caso di errore.

Commenti

Usare le funzioni seguenti per specificare informazioni aggiuntive da inviare:

Per inviare le informazioni, chiamare la funzione WerReportSubmit . Al termine dell'handle del report, chiamare la funzione WerReportCloseHandle .

Le applicazioni possono anche indicare che desiderano l'opportunità di recuperare dati o riavviare in caso di errore. Per altre informazioni, vedere Ripristino e riavvio dell'applicazione.

Per visualizzare i report inviati dall'applicazione, passare a Windows Quality Online Services.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	werapi.h
Libreria	Wer.lib
DLL	Wer.dll

Vedi anche

Ripristino e riavvio dell'applicazione, WER_REPORT_INFORMATION, WerReportCloseHandle, WerReportSubmit, Segnalazione errori Windows

Condividi tramite