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
标头 winreg.h (包括 Windows.h)
Library Advapi32.lib
DLL Advapi32.dll

另请参阅

FormatMessage

低级别访问控制

低级别访问控制函数

RegCloseKey

RegDeleteKey

RegGetKeySecurity

SECURITY_DESCRIPTOR

SECURITY_INFORMATION