Поделиться через

Функция ORSetVirtualFlags

  • Статья

Задает флаги виртуализации для указанного открытого раздела реестра в автономном кусте реестра.

Синтаксис

DWORD ORSetVirtualFlags(
  _In_ ORHKEY Handle,
  _In_ DWORD  dwFlags
);

Параметры

Дескриптор [in]

Дескриптор открытого раздела реестра в автономном кусте реестра.

dwFlags [in]

Этот параметр управляет поведением реестра при сбое операции создания или открытия ключа в виртуализированном кусте. Этот параметр может иметь одно или несколько из следующих значений.

Значение Значение
REG_KEY_DONT_SILENT_FAIL
4
 Если этот флаг установлен и операция Открыть завершается сбоем для ключа, для которого включена виртуализация, реестр не пытается повторно открыть раздел. Если этот флаг недоступен, реестр пытается повторно открыть раздел с доступом MAXIMUM_ALLOWED.
REG_KEY_DONT_VIRTUALIZE
2
 Если этот флаг установлен и операция создания ключа завершается сбоем, так как вызывающий объект не имеет KEY_CREATE_SUB_KEY право на родительский ключ, реестр завершается ошибкой при выполнении операции Создания. Если этот флаг не задан, реестр пытается создать раздел в виртуальном хранилище. Вызывающий объект должен иметь KEY_READ прямо на родительском ключе.
REG_KEY_RECURSE_FLAG
8
 Если этот флаг установлен, флаги виртуализации реестра распространяются из родительского раздела. Если этот флаг не задан, флаги виртуализации реестра не распространяются.

 

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение будет ERROR_SUCCESS.

Если функция завершается сбоем, возвращаемое значение представляет собой ненулевой код ошибки, определенный в Winerror.h. Чтобы получить общее описание ошибки, можно использовать функцию FormatMessage с флагом FORMAT_MESSAGE_FROM_SYSTEM.

Комментарии

Виртуализация реестра — это промежуточная технология совместимости приложений, которая позволяет выполнять операции записи в реестр, которые оказывают глобальное влияние, перенаправляться в расположения для каждого пользователя. Это перенаправление является прозрачным для приложений, считывающих данные из реестра или записывающего их в реестр.

Виртуализация реестра поддерживается начиная с Windows Vista. Тем не менее, корпорация Майкрософт намерена удалить ее из будущих версий операционной системы Windows, так как все больше приложений становятся совместимыми с Windows Vista. Поэтому приложения не должны зависеть от поведения виртуализации реестра в системе.

Виртуализация реестра включена только для следующих компонентов:

  • 32-разрядные интерактивные процессы
  • Ключи в HKEY_LOCAL_MACHINE\Software
  • Ключи, в которые администратор может записать

Дополнительные сведения см. в разделе Виртуализация реестра.

Требования

Требование Значение
Распространяемые компоненты
 Библиотека автономного реестра Windows версии 1.0 или более поздней
Заголовок
Offreg.h
DLL
Offreg.dll

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

ORGetVirtualFlags

Виртуализация реестра