RegSetKeySecurity 函数 (winreg.h)

项目
03/04/2024

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