Функция ORSaveHive
Записывает указанный автономный куст реестра в файл.
Синтаксис
DWORD ORSaveHive(
_In_ ORHKEY Handle,
_In_ PCWSTR lpHivePath,
_In_ DWORD dwOsMajorVersion,
_In_ DWORD dwOsMinorVersion
);
Параметры
-
Дескриптор [в]
-
Дескриптор автономного куста реестра для сохранения.
-
lpHivePath [in]
-
Указатель на строку Юникода, указывающую имя файла hive реестра. Это не может быть имя существующего файла.
-
dwOsMajorVersion [in]
-
Основной номер версии операционной системы. Этот элемент может быть одним из следующих значений.
Значение Значение - 5
Если dwOsMinorVersion имеет значение 1, операционная система — Windows XP.
Если dwOsMinorVersion имеет значение 2, операционная система — Windows Server 2003 R2, Windows Server 2003 или Windows XP Professional x64 Edition.- 6
Если dwOsMinorVersion имеет значение 0, операционная система — Windows Server 2008 или Windows Vista.
Если dwOsMinorVersion имеет значение 1, операционная система — Windows Server 2008 R2 или Windows 7. -
dwOsMinorVersion [in]
-
Дополнительный номер версии операционной системы. Этот элемент может быть одним из следующих значений.
Значение Значение - 0
Если dwOsMajorVersion имеет значение 6, операционная система — Windows Server 2008 или Windows Vista. - 1
Если dwOsMajorVersion имеет значение 5, операционная система — Windows XP.
Если dwOsMajorVersion имеет значение 6, операционная система — Windows Server 2008 R2 или Windows 7.- 2
Если dwOsMajorVersion имеет значение 5, операционная система — Windows Server 2003 R2, Windows Server 2003 или Windows XP Professional x64 Edition.
Если dwOsMajorVersion имеет значение 6, параметр dwOsMinorVersion должен иметь значение 0 или 1.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение будет ERROR_SUCCESS.
Если функция завершается сбоем, возвращаемое значение представляет собой код ошибки, отличный от нуля, определенный в Winerror.h. Чтобы получить общее описание ошибки, можно использовать функцию FormatMessage с флагом FORMAT_MESSAGE_FROM_SYSTEM. Возможные коды ошибок:
- Если вызывающий объект не имеет необходимых прав доступа для записи файла, функция возвращает ERROR_ACCESS_DENIED.
- Если указанный файл уже существует, функция возвращает ERROR_ALREADY_EXISTS.
Комментарии
Функция ORSaveHive должна использоваться для сохранения изменений, внесенных в автономный куст реестра. Изменения не сохраняются до вызова ORSaveHive для сохранения куста в файл.
Параметры dwOsMajorVersion и dwOsMinorVersion вместе определяют целевой формат файла hive реестра. В следующей таблице перечислены последние номера версий операционной системы.
Операционная система | номер версии; |
---|---|
Windows Server 2008 R2 | 6.1 |
Windows 7 | 6.1 |
Windows Server 2008 | 6,0 |
Windows Vista | 6,0 |
Windows Server 2003 R2 | 5,2 |
Windows Server 2003 | 5,2 |
Windows XP Professional x64 Edition | 5,2 |
Windows XP | 5,1 |
Используйте функцию GetVersionEx для получения сведений о текущей операционной системе.
Функция ORSaveHive блокирует куст реестра во время записи куста в файл, а затем закрывает файл и снимает блокировку. Куст реестра остается в памяти, пока не будет закрыт путем вызова функции ORCloseHive . Вы можете внести дальнейшие изменения в куст реестра, пока он открыт. Однако для сохранения этих изменений куст необходимо сохранить в новый файл, так как функция ORSaveHive не перезаписывает существующий файл.
Функция ORSaveHive может использоваться для сохранения части автономного куста реестра. Ключ, указанный в параметре Handle , становится корневым ключом куста, который состоит из указанного ключа и всех его подразделов.
Требования
Требование | Значение |
---|---|
Распространяемые компоненты |
Библиотека автономного реестра Windows версии 1.0 или более поздней |
Заголовок |
|
DLL |
|
См. также раздел