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

Статья
08/27/2023

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