Exception Mode
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/27/2008
In Exception mode, the Report Upload Client can operate with or without a user interface.
Using Report Upload Client with a User Interface
If a device has a user interface (UI), the Report Upload Client UI presents the following dialog boxes to the user that notify the user of the Error Reporting process, and gets user consent for upload.
- The Send Report dialog box
This dialog box tells the user that an application crash occurred and identifies the faulting application. The Send Report dialog also gets the user's permission for upload.
On this dialog box, the user can select the Report Details button to see more information. - The Report Details dialog box
This dialog box provides more information about the application and module that crashed. It also provides information regarding the privacy of the data in the report and how the data is treated.
On this dialog box, the user can select the Report Contents button to see detailed report contents, such as the faulting exception, module and thread information, and memory dumps.
After the report is sent to the watson.microsoft.com web site, the Report Upload Client UI displays an Error Reporting dialog that thanks the user for sending an error report.
Because error report files are in binary format, report details must be translated to text before they can be displayed to the user in the dialog boxes.
The Report Upload Client calls the Report Client UI when it requests user consent, and when it receives a response from the Watson server after an upload.
You can modify the Report Upload Client UI to customize the display. The Report Upload Client UI is in the %_WINCEROOT%\public\wceshellfe\oak\Watson\DwUi directory. You can use this code with or without modification.
The main entry points into the Report Upload Client UI library are GetUserConsent and WatsonUploadResponse.
During the processing of GetUserConsent, the Report Upload Client makes a number of calls to API in DwDmpTxt.lib. For more information about the API in DwDmpTxt.lib, see Report Upload Client Reference.
Using Report Upload Client Without a User Interface
For the Report Upload Client to upload a report on a device without a user interface, the NoConsentRequired option must be enabled in the registry.
This setting should only be enabled after the user has provided consent during device setup.