BCryptSetContextFunctionProperty 函数 (bcrypt.h)

  • 项目

BCryptSetContextFunctionProperty 函数设置现有 CNG 上下文中加密函数的命名属性的值。

语法

NTSTATUS BCryptSetContextFunctionProperty(
  [in] ULONG   dwTable,
  [in] LPCWSTR pszContext,
  [in] ULONG   dwInterface,
  [in] LPCWSTR pszFunction,
  [in] LPCWSTR pszProperty,
  [in] ULONG   cbValue,
  [in] PUCHAR  pbValue
);

参数

[in] dwTable

标识上下文所在的配置表。 这可以是以下值之一。

值 含义
CRYPT_LOCAL
 上下文存在于本地计算机配置表中。
CRYPT_DOMAIN
 此值不可用。

[in] pszContext

指向以 null 结尾的 Unicode 字符串的指针，该字符串包含要设置函数属性的上下文的标识符。

[in] dwInterface

标识函数所在的加密接口。 这可以是以下值之一。

值 含义
BCRYPT_ASYMMETRIC_ENCRYPTION_INTERFACE
 函数存在于非对称加密函数列表中。
BCRYPT_CIPHER_INTERFACE
 函数存在于密码函数列表中。
BCRYPT_HASH_INTERFACE
 该函数存在于哈希函数列表中。
BCRYPT_RNG_INTERFACE
 函数存在于随机数生成器函数的列表中。
BCRYPT_SECRET_AGREEMENT_INTERFACE
 函数存在于机密协议函数列表中。
BCRYPT_SIGNATURE_INTERFACE
 该函数存在于签名函数列表中。
NCRYPT_KEY_STORAGE_INTERFACE
 该函数存在于密钥存储函数列表中。
NCRYPT_SCHANNEL_INTERFACE
 函数存在于 Schannel 函数列表中。

[in] pszFunction

指向以 null 结尾的 Unicode 字符串的指针，该字符串包含要为其设置属性的加密函数的标识符。

[in] pszProperty

指向以 null 结尾的 Unicode 字符串的指针，该字符串包含要设置的属性的标识符。

[in] cbValue

包含 pbValue 缓冲区的大小（以字节为单位）。 这是将存储的确切字节数。 如果属性值是字符串，则应根据需要添加一个字符的大小，以同时存储终止 null 字符。

[in] pbValue

包含新属性值的缓冲区的地址。

返回值

返回指示函数成功或失败的状态代码。

可能的返回代码包括但不限于以下内容。

返回代码 说明
STATUS_SUCCESS
 函数成功。
STATUS_ACCESS_DENIED
 调用方对函数的属性没有写入访问权限。
STATUS_INVALID_PARAMETER
 一个或多个参数无效。
STATUS_NO_MEMORY
 发生内存分配失败。
STATUS_NOT_FOUND
 找不到指定的上下文或函数。

注解

只能在用户模式下调用 BCryptSetContextFunctionProperty。

要求

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