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 |