Функция ORSaveHive

Статья
06/12/2023

Записывает указанный автономный куст реестра в файл.

Синтаксис

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 или более поздней
Заголовок	Offreg.h
DLL	Offreg.dll

См. также раздел

GetVersionEx
ORCloseHive
OROpenHive