Función WerReportSubmit (werapi.h)

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