Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function places the operating system (OS) in a state in which the registry can be replaced by the supplied file on a warm boot.

Syntax 

BOOL RegRestoreFile(
  LPCWSTR 
lpszFile
);

Parameters

lpszFile

[in] Specifies the name of the file to be saved. The file can exist on any mounted file system that is accessible to the OS.

Return Value

TRUE indicates success; FALSE indicates failure. To get extended error information, call GetLastError. GetLastErrormay fail, returning ERROR_NOT_SUPPORTED.

Remarks

This function is supported only for the object store-based registry. To save and restore data in the hive-based registry, see RegReplaceKey.

Requirements

Header pwinreg.h
Library coredll.lib
Windows Embedded CE Windows CE 2.10 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also