Функция SfcIsKeyProtected (sfc.h)

Статья
03/15/2023

Определяет, защищен ли указанный раздел реестра. Приложения не должны заменять защищенные разделы реестра.

Синтаксис

BOOL SfcIsKeyProtected(
  [in]           HKEY    KeyHandle,
  [in, optional] LPCWSTR SubKeyName,
  [in]           REGSAM  KeySam
);

Параметры

[in] KeyHandle

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

HKEY_CLASSES_ROOT

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

[in, optional] SubKeyName

Строковое значение, завершающееся null, содержащее имя подраздела. Этот ключ должен содержать подраздел ключа, определяемого параметром hKey . Дополнительные сведения об именах ключей см. в разделе Структура реестра. Если этот параметр имеет значение NULL, функция только проверяет, защищен ли корневой раздел реестра.

[in] KeySam

Константа, указывающая альтернативное представление реестра, которое должно использоваться приложениями, работающими в 64-разрядной версии Windows. Этот флаг игнорируется на платформе x86. Дополнительные сведения см. в разделе Доступ к альтернативному представлению реестра.

Значение	Значение
0x0000	Используйте 32-разрядный раздел реестра из 32-разрядных приложений и 64-разрядный раздел реестра из 64-разрядных приложений.
KEY_WOW64_64KEY 0x0100	Используйте 64-разрядный раздел реестра из 32-разрядного или 64-разрядного приложения.
KEY_WOW64_32KEY 0x0200	Используйте 32-разрядный раздел реестра из 32-разрядного или 64-разрядного приложения.

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

Если ключ защищен, возвращаемое значение является ненулевым.

Если ключ не защищен, возвращаемое значение равно нулю.

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

HKEY_LOCAL_MACHINE
   SOFTWARE
      Classes
         Microsoft
            <WinFeature>
               <new subkey>

Требования


Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	sfc.h
Библиотека	Sfc.lib
DLL	Sfc.dll

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

SfcIsFileProtected

Share via