Функция RegDisableReflectionKey (winreg.h)

Статья
08/27/2023

Отключает отражение реестра для указанного раздела. Отключение отражения для ключа не влияет на отражение подразделов.

Синтаксис

LONG RegDisableReflectionKey(
  [in] HKEY hBase
);

Параметры

[in] hBase

Дескриптор открытого раздела реестра. Этот дескриптор возвращается функцией RegCreateKeyEx, RegCreateKeyTransacted, RegOpenKeyEx или RegOpenKeyTransacted ; Невозможно указать ключ на удаленном компьютере.

Если ключ отсутствует в списке отражения, функция выполняется успешно, но не оказывает никакого влияния. Дополнительные сведения см. в разделе Перенаправитель реестра и отражение реестра.

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

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

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

В WOW64 32-разрядные приложения просматривают дерево реестра, отдельное от дерева реестра, которое просматривает 64-разрядные приложения. Отражение реестра копирует определенные разделы и значения реестра между двумя представлениями.

Чтобы восстановить отражение реестра для отключенного раздела, используйте функцию RegEnableReflectionKey .

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista, Windows XP Professional x64 Edition [только классические приложения]
Минимальная версия сервера	Windows Server 2008, Windows Server 2003 с пакетом обновления 1 (SP1) [только классические приложения]
Целевая платформа	Windows
Header	winreg.h (включая Windows.h)
Библиотека	Advapi32.lib
DLL	Advapi32.dll