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

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

  • Статья

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

Синтаксис

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-разрядного приложения.

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

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

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

Комментарии

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

Например, если следующий раздел реестра существует в системе и защищен С помощью WRP:

HKEY_LOCAL_MACHINE
   SOFTWARE
      Classes
         Microsoft
            <WinFeature>

Функция 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