Funzione WerReportSubmit (werapi.h)
Invia il report di Segnalazione errori Windows (WER) specificato.
Sintassi
HRESULT WerReportSubmit(
[in] HREPORT hReportHandle,
[in] WER_CONSENT consent,
[in] DWORD dwFlags,
[out, optional] PWER_SUBMIT_RESULT pSubmitResult
);
Parametri
[in] hReportHandle
Handle per il report. Questo handle viene restituito dalla funzione WerReportCreate .
[in] consent
Stato del consenso. Questo parametro può essere uno dei valori seguenti dal tipo di enumerazione WER_CONSENT .
| Valore | Significato |
|---|---|
| WerConsentAlwaysPrompt 4 |
L'utente viene sempre chiesto di inviare la richiesta. |
| WerConsentApproved 2 |
L'utente ha approvato la richiesta di invio. |
| WerConsentDenied 3 |
L'utente ha negato la richiesta di invio. |
| WerConsentMax 5 |
Valore massimo per il tipo di enumerazione WER_CONSENT. |
| WerConsentNotAsked 1 |
L'utente non ha richiesto il consenso. |
[in] dwFlags
Questo parametro può essere uno o più dei valori seguenti.
| Valore | Significato |
|---|---|
| WER_SUBMIT_ADD_REGISTERED_DATA 16 |
Aggiungere i dati registrati da WerSetFlags, WerRegisterFile e WerRegisterMemoryBlock al report. |
| WER_SUBMIT_HONOR_RECOVERY 1 |
Onorare qualsiasi registrazione di ripristino per l'applicazione. Per altre informazioni, vedere RegisterApplicationRecoveryCallback. |
| WER_SUBMIT_HONOR_RESTART 2 |
Onorare qualsiasi registrazione di riavvio per l'applicazione. Per altre informazioni, vedere RegisterApplicationRestart. |
| WER_SUBMIT_NO_ARCHIVE 256 |
Non archiviare il report. |
| WER_SUBMIT_NO_CLOSE_UI 64 |
Non visualizzare la finestra di dialogo di chiusura per il report critico. |
| WER_SUBMIT_NO_QUEUE 128 |
Non accoda il report. Se il report viene inviato immediatamente a Microsoft per il consenso dell'utente adeguato; in caso contrario, il report viene rimosso. È possibile usare questo flag per i report non critici. Il report viene rimosso per qualsiasi azione che richiede che il report venga accodato. Ad esempio, se il computer è offline quando si invia il report, il report viene eliminato. Inoltre, se è presente un consenso insufficiente (ad esempio, è stato richiesto il consenso per la parte dei dati del report), il report viene rimosso. |
| WER_SUBMIT_OUTOFPROCESS 32 |
Genera un altro processo per inviare il report. Il thread chiamante viene bloccato fino a quando la funzione non restituisce. NOTA: I messaggi della finestra verranno pompati in modo che l'attività dell'interfaccia utente nel thread chiamante non venga bloccata. |
| WER_SUBMIT_OUTOFPROCESS_ASYNC 1024 |
Generare un altro processo per inviare il report e restituire immediatamente da questa chiamata di funzione. Si noti che il contenuto del parametro pSubmitResult non è definito e non è possibile eseguire query quando il report viene completato o lo stato di completamento. |
| WER_SUBMIT_QUEUE 4 |
Aggiungere il report alla coda WER senza inviare una notifica all'utente. Il report viene accodato solo: la creazione di report (invio del report a Microsoft) viene eseguita in un secondo momento in base al livello di consenso dell'utente. |
| WER_SUBMIT_SHOW_DEBUG 8 |
Mostra il pulsante di debug. |
| WER_SUBMIT_START_MINIMIZED 512 |
L'interfaccia utente iniziale viene ridotta al minimo e lampeggiante. |
| WER_SUBMIT_BYPASS_DATA_THROTTLING 2048 |
Ignorare la limitazione dei dati per il report. Windows 7 o versioni precedenti: Questo parametro non è disponibile. |
| WER_SUBMIT_ARCHIVE_PARAMETERS_ONLY 4096 |
Archiviare solo i parametri; la cabina viene rimossa. Questo flag esegue l'override dell'impostazione ConfigureArchive WER. Windows 7 o versioni precedenti: Questo parametro non è disponibile. |
| WER_SUBMIT_REPORT_MACHINE_ID 8192 |
Invia sempre l'identificatore del computer univoco a 128 bit con il report, indipendentemente dal consenso con cui è stato inviato il report. Per altre informazioni, vedere Osservazioni. Windows 7 o versioni precedenti: Questo parametro non è disponibile. |
[out, optional] pSubmitResult
Risultato dell'invio. Questo parametro può essere uno dei valori seguenti dal tipo di enumerazione WER_SUBMIT_RESULT .
| Valore | Significato |
|---|---|
| WerCustomAction 9 |
La segnalazione degli errori può essere personalizzata. |
| WerDisabled 5 |
Segnalazione errori disabilitata. |
| WerDisabledQueue 7 |
L'accodamento è stato disabilitato. |
| WerReportAsync 8 |
Il report è asincrono. |
| WerReportCancelled 6 |
Il report è stato annullato. |
| WerReportDebug 3 |
È stato fatto clic sul pulsante Debug. |
| WerReportFailed 4 |
L'invio del report non è riuscito. |
| WerReportQueued 1 |
Il report è stato accodato. |
| WerReportUploaded 2 |
Il report è stato caricato. |
Valore restituito
Questa funzione restituisce S_OK in caso di esito positivo o di codice di errore in caso di errore.
Commenti
Dopo che l'applicazione chiama questa funzione, WER raccoglie i dati specificati. Se il parametro di consenso è WerConsentApproved, invia il report a Microsoft. Se il consenso è WerConsentNotAsked, verrà visualizzata la finestra di dialogo di consenso. Per determinare lo stato di invio, controllare il parametro pSubmitResult .
In caso di evento critico dell'applicazione, le applicazioni registrate per il riavvio verranno riavviate.
L'identificatore del computer viene inviato con il report quando:
- Il consenso utilizzato per inviare il report non proviene dall'applicazione. Ad esempio, il report è stato inviato con stato di consenso impostato su WerConsentNotAsked.
- Il report è stato inviato con il flag WER_SUBMIT_REPORT_MACHINE_ID impostato.
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 delle applicazioni, WerReportCreate, Segnalazione errori Windows