NCryptRegisterProtectionDescriptorName 函数 (ncryptprotect.h)

  • 项目

NCryptRegisterProtectionDescriptorName 函数注册保护描述符的显示名称和关联的规则字符串。

语法

SECURITY_STATUS NCryptRegisterProtectionDescriptorName(
  [in]           LPCWSTR pwszName,
  [in, optional] LPCWSTR pwszDescriptorString,
                 DWORD   dwFlags
);

参数

[in] pwszName

指向以 null 结尾的 Unicode 字符串的指针，该字符串包含要注册的描述符的显示名称。

[in, optional] pwszDescriptorString

指向包含保护描述符规则的以 null 结尾的 Unicode 字符串的指针。 如果此参数为 NULL 或字符串为空，则将删除以前为 pwszName 参数创建的注册表值。

dwFlags

一个常量，指示注册新条目时使用的注册表配置单元。 如果此值为零 (0) ，则 注册表根目录HKEY_CURRENT_USER。 如果此值 NCRYPT_MACHINE_KEY_FLAG，则 根HKEY_LOCAL_MACHINE。

返回值

返回指示函数成功或失败的状态代码。 可能的返回代码包括但不限于以下内容。

返回代码 说明
ERROR_SUCCESS
 函数成功。
NTE_INVALID_PARAMETER
 pwszName 参数不能为 NULL，参数指向的值不能为空字符串。
NTE_BAD_FLAGS
 dwFlags 参数必须为零或NCRYPT_MACHINE_KEY_FLAG。

注解

使用此函数创建的注册表项不是易失的。 信息存储在文件中，并在计算机关闭时保留。

要求

要求 值
最低受支持的客户端 Windows 8 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 [仅限桌面应用]
目标平台 Windows
标头 ncryptprotect.h
Library NCrypt.lib
DLL NCrypt.dll

另请参阅

CNG DPAPI 函数

NCryptQueryProtectionDescriptorName