Upload Dump Files (Compact 7)
3/12/2014
By default, when Windows Embedded Compact Error Reporting generates a dump file on a device, it compresses the dump file into a CAB file and, with user consent, uploads it to the Microsoft Watson website for analysis by Windows Embedded Compact developers. (You can also upload the files to your own website by editing %_WINCEROOT%\public\COMMON\oak\inc\dwpublic.h and code in the directory %_WINCEROOT%\public\wceshellfe\oak\Watson\DwUi.) Alternatively, you can configure a registry setting to save the dump files on the device. You might choose this option, for example, if the device does not have Internet access, or if you want to retrieve and analyze the dump files without contacting Microsoft for the Watson data. For information about how to save the dump files, see Save Dump Files on a Device.
You can set upload options such as whether to require consent by the user if the device has a UI, the maximum number of reports to upload daily, whether to display upload status dialog boxes, and so on, by using the Report Upload Client Registry Settings. To set other aspects of Error Reporting functionality, such as the type of dump file to generate, the maximum size of the dump file, and so on, see Error Reporting Registry Settings, Error Report Generator Registry Settings, Error Report Transfer Driver Registry Settings, and Error Report Control Panel Registry Settings.
If a device has a UI, the Report Upload Client UI presents the following dialog boxes to the user. These dialog boxes notify the user of the Error Reporting process and obtain user consent for upload.
- Send Report
This dialog box identifies the failed application and tells the user that an application crash occurred. The user can click the Report Details button for more information. The Send Report dialog box also requests the user's permission to upload the dump file. - Report Details
This dialog box provides more information about the code that crashed. It also provides information regarding the privacy of the data in the report and how the data is used. In this dialog box, the user can click the Report Contents button to see detailed report contents, such as the exception, module and thread information, and memory dumps.
After the report is sent to the Microsoft Watson website, the Report Upload Client UI displays an Error Reporting dialog box that thanks the user for sending an error report. You can modify the Report Upload Client UI to customize the dialog box. 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 instructions below explain how to incorporate the functionality into your OS design to upload dump files.
Note
These instructions assume that you leave all other Error Reporting registry settings at their default values. The default registry setting values are indicated in Error Reporting Registry Settings, Error Report Generator Registry Settings, Error Report Transfer Driver Registry Settings, Report Upload Client Registry Settings, and Error Report Control Panel Registry Settings.
To upload dump files to the Microsoft Watson website
In your OS design, include the Error Reporting catalog items that are needed to upload dump files, as indicated in Include Error Reporting in the OS.
If you would like to change the upload settings from their default values, set the associated values in the registry of the device by using the procedure in Configure Registry Settings for Error Reporting. For more information about registry settings related to report uploading, see Report Upload Client Registry Settings.
Important
If the device does not have a UI, you need to set NoConsentRequired in the registry in order for the Report Upload Client to upload a report. For more information, see Report Upload Client Registry Settings. However, you should only use this setting if a user provides consent during device setup.