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


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

Функция RegSetKeySecurity задает безопасность открытого раздела реестра.

Синтаксис

LSTATUS RegSetKeySecurity(
  [in] HKEY                 hKey,
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

Параметры

[in] hKey

Дескриптор открытого ключа, для которого задан дескриптор безопасности .

[in] SecurityInformation

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

[in] pSecurityDescriptor

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

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

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

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

Комментарии

Если hKey является одним из предопределенных ключей, используйте функцию RegCloseKey , чтобы закрыть предопределенный ключ, чтобы убедиться, что новые сведения о безопасности будут действовать при следующей ссылке на предопределенный ключ.

Требования

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

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

FormatMessage

Низкоуровневые контроль доступа

Низкоуровневые функции контроль доступа

RegCloseKey

RegDeleteKey

RegGetKeySecurity

SECURITY_DESCRIPTOR

SECURITY_INFORMATION