Chromium Triggered Reset API (Windows-only)
Chromium (and Google Chrome) on Windows provide a way for third parties to trigger a reset flow the next time a Chromium profile is opened by the user.
The reset flow will prompt the user to reset their settings to the built-in default state of the browser when it was first installed on the system.
This mechanism is intended to be used by third parties implementing clean up tools who wish to provide a way to prompt a user to clean their settings. If the user accepts the prompt, then their homepage, new tab page and search engine will be set back to factory defaults, all of their extensions will be disabled (though not removed) and all pinned tabs will be unpinned.
The prompt the user receives will look like this:
How to use it
Chromium on Windows exposes the triggered profile reset API through the registry, a place that is easy and convenient for a third party Windows tool to write to.
To use the triggered reset flow, the third party tool will :
## **Create (or open) the registry key HCKU\\Software\\Chromium\\TriggeredReset or HCKU\\Software\\Google\\Chrome\\TriggeredReset, depending which distribution you are targeting.** ## **Set a REG_SZ value called "ToolName" to the name of the tool. This string will be displayed in a notification UI. The "ToolName" should be just the name of the tool, e.g. "AwesomeAV".** ## **Set a REG_QWORD value called "Timestamp" with the timestamp of the reset. This value should be obtained from a call to ::GetSystemTimeAsFileTime(). The value will be persisted in a reset profile and will be used to avoid multiple resets. The value will not be cleared from the registry by Chromium.**