Función WerReportSubmit (werapi.h)

  • Artículo

Envía el informe de Informe de errores de Windows especificado (WER).

Sintaxis

HRESULT WerReportSubmit(
  [in]            HREPORT            hReportHandle,
  [in]            WER_CONSENT        consent,
  [in]            DWORD              dwFlags,
  [out, optional] PWER_SUBMIT_RESULT pSubmitResult
);

Parámetros

[in] hReportHandle

Identificador del informe. La función WerReportCreate devuelve este identificador.

[in] consent

Estado de consentimiento. Este parámetro puede ser uno de los siguientes valores del tipo de enumeración WER_CONSENT .

Valor Significado
WerConsentAlwaysPrompt
4		 Siempre se pide al usuario que envíe la solicitud.
WerConsentApproved
2		 El usuario ha aprobado la solicitud de envío.
WerConsentDenied
3		 El usuario ha denegado la solicitud de envío.
WerConsentMax
5		 Valor máximo del tipo de enumeración WER_CONSENT .
WerConsentNotAsked
1		 No se solicitó el consentimiento del usuario.

[in] dwFlags

Este parámetro puede ser uno o más de los siguientes valores.

Valor Significado
WER_SUBMIT_ADD_REGISTERED_DATA
16		 Agregue los datos registrados por WerSetFlags, WerRegisterFile y WerRegisterMemoryBlock al informe.
WER_SUBMIT_HONOR_RECOVERY
1		 Respeta cualquier registro de recuperación de la aplicación. Para obtener más información, vea RegisterApplicationRecoveryCallback.
WER_SUBMIT_HONOR_RESTART
2		 Respeta cualquier registro de reinicio de la aplicación. Para obtener más información, consulte RegisterApplicationRestart.
WER_SUBMIT_NO_ARCHIVE
256		 No archive el informe.
WER_SUBMIT_NO_CLOSE_UI
64		 No muestre el cuadro de diálogo Cerrar para el informe crítico.
WER_SUBMIT_NO_QUEUE
128		 No poner en cola el informe. Si hay el consentimiento adecuado del usuario, el informe se envía a Microsoft inmediatamente; de lo contrario, se descarta el informe. Puede usar esta marca para los informes no críticos.

El informe se descarta para cualquier acción que requiera que el informe se pone en cola. Por ejemplo, si el equipo está sin conexión al enviar el informe, el informe se descarta. Además, si no hay consentimiento suficiente (por ejemplo, se requería consentimiento para la parte de datos del informe), el informe se descarta.
WER_SUBMIT_OUTOFPROCESS
32		 Genere otro proceso para enviar el informe. El subproceso que realiza la llamada se bloquea hasta que se devuelve la función.

NOTA: Los mensajes de ventana se bombean para que no se bloquee la actividad de la interfaz de usuario en el subproceso que realiza la llamada.
WER_SUBMIT_OUTOFPROCESS_ASYNC
1024		 Genere otro proceso para enviar el informe y volver de esta llamada de función inmediatamente. Tenga en cuenta que el contenido del parámetro pSubmitResult no está definido y no hay forma de consultar cuándo se completa el informe o el estado de finalización.
WER_SUBMIT_QUEUE
4		 Agregue el informe a la cola WER sin notificar al usuario. El informe solo se pone en cola: los informes (envío del informe a Microsoft) se producen más adelante en función del nivel de consentimiento del usuario.
WER_SUBMIT_SHOW_DEBUG
8		 Muestra el botón depurar.
WER_SUBMIT_START_MINIMIZED
512		 La interfaz de usuario inicial se minimiza y parpadea.
WER_SUBMIT_BYPASS_DATA_THROTTLING
2048		 Omita la limitación de datos para el informe.

Windows 7 o versiones anteriores: Este parámetro no está disponible.
WER_SUBMIT_ARCHIVE_PARAMETERS_ONLY
4096		 Archivar solo los parámetros; se descarta el taxi. Esta marca invalida la configuración de ConfigureArchive WER.

Windows 7 o versiones anteriores: Este parámetro no está disponible.
WER_SUBMIT_REPORT_MACHINE_ID
8192		 Envíe siempre el identificador único de equipo de 128 bits con el informe, independientemente del consentimiento con el que se envió el informe. Vea Comentarios para obtener información adicional.

Windows 7 o versiones anteriores: Este parámetro no está disponible.

[out, optional] pSubmitResult

Resultado del envío. Este parámetro puede ser uno de los siguientes valores del tipo de enumeración WER_SUBMIT_RESULT .

Valor Significado
WerCustomAction
9		 Los informes de errores se pueden personalizar.
WerDisabled
5		 Se deshabilitó el informe de errores.
WerDisabledQueue
7		 La puesta en cola estaba deshabilitada.
WerReportAsync
8		 El informe era asincrónico.
WerReportCancelled
6		 Se canceló el informe.
WerReportDebug
3		 Se hizo clic en el botón Depurar.
WerReportFailed
4		 Error en el envío del informe.
WerReportQueued
1		 El informe se puso en cola.
WerReportUploaded
2		 Se cargó el informe.

Valor devuelto

Esta función devuelve S_OK si se ejecuta correctamente o un código de error en caso de error.

Comentarios

Una vez que la aplicación llama a esta función, WER recopila los datos especificados. Si el parámetro de consentimiento es WerConsentApproved, envía el informe a Microsoft. Si el consentimiento es WerConsentNotAsked, WER muestra el cuadro de diálogo de consentimiento. Para determinar el estado del envío, compruebe el parámetro pSubmitResult .

En caso de que se produzca un evento crítico de la aplicación, se reiniciarán las aplicaciones que se hayan registrado para el reinicio .

El identificador del equipo se envía con el informe cuando:

  • El consentimiento usado para enviar el informe no procede de la aplicación. Por ejemplo, el informe se envió con el estado de consentimiento establecido en WerConsentNotAsked.
  • El informe se envió con la marca WER_SUBMIT_REPORT_MACHINE_ID establecida.

Para ver los informes enviados por la aplicación, vaya a Windows Quality Online Services.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado werapi.h
Library Wer.lib
Archivo DLL Wer.dll

Consulte también

Recuperación y reinicio de aplicaciones, WerReportCreate, Informe de errores de Windows