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