LONG RegRestoreKey( HKEY hKey, // дескриптор ключа, который восстанавливается LPCTSTR lpFile, // адрес файла DWORD dwFlags // опции );
Параметры:
hKey | Идентифицирует открытый в текущий момент ключ или один из следующих предопределенных значений дескрипторов: HKEY_CLASSES_ROOT HKEY_CURRENT_USER HKEY_LOCAL_MACHINE HKEY_USERS HKEY_CURRENT_CONFIG |
lpFile | Адрес нульзаканчивающейся строки, содержащей имя файла, в который будут сохранен указанный ключ и его подключи. Этот файл не может существовать до вызова функции. |
lpSecurityAttributes | Windows NT/2000/XP: Адрес структуры SECURITY_ATTRIBUTES, которая определяет дескриптор безопасности для нового файла. Если lpSecurityAttributes равен NULL, файл получает дескриптор безопасности по умолчанию. В старых версиях Windows (95/98/Me), этот параметр игнорируется. |
Возвращаемые значения:
Если функция успешно, возвращается значение ERROR_SUCCESS.При ошибке, возвращаемое значение – это код ошибки, объявленный в WINERROR.H. Вы можете использовать функцию FormatMessage с флагом FORMAT_MESSAGE_FROM_SYSTEM для получения общего описания ошибки.
Замечания:
Функция RegSaveKey сохраняет только постоянные ключи. Ключ, делается постоянным или непостоянным ппри его создании; смотрите RegCreateKeyEx.Windows NT/2000/XP: Вызывающий процесс должен иметь привилегию SE_BACKUP_NAME.