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

Функция ORGetVirtualFlags

  • Статья

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

Синтаксис

DWORD ORGetVirtualFlags(
  _In_  ORHKEY Handle,
  _Out_ PDWORD pdwFlags
);

Параметры

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

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

pdwFlags [out]

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

Значение Значение
REG_KEY_DONT_SILENT_FAIL
4
 Если этот флаг установлен и операция Open завершается сбоем для ключа с включенной виртуализацией, реестр не пытается повторно открыть раздел. Если этот флаг не установлен, реестр пытается повторно открыть раздел с 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

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

ORSetVirtualFlags

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