BCryptConfigureContextFunction 函数 (bcrypt.h)

  • 项目

[BCryptConfigureContextFunction 可用于“要求”部分中指定的操作系统。 在后续版本中，它可能已更改或不可用。]

BCryptConfigureContextFunction 函数设置现有 CNG 上下文的加密函数的配置信息。

语法

NTSTATUS BCryptConfigureContextFunction(
  [in] ULONG                          dwTable,
  [in] LPCWSTR                        pszContext,
  [in] ULONG                          dwInterface,
  [in] LPCWSTR                        pszFunction,
  [in] PCRYPT_CONTEXT_FUNCTION_CONFIG pConfig
);

参数

[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 函数列表中设置函数配置信息。
NCRYPT_SCHANNEL_SIGNATURE_INTERFACE
 在 Schannel 接受的 TLS 1.2 签名套件列表中设置函数配置信息。

Windows Vista 和 Windows Server 2008： 不支持此值。

[in] pszFunction

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

[in] pConfig

包含新函数配置信息的 CRYPT_CONTEXT_FUNCTION_CONFIG 结构的地址。

返回值

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

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

返回代码 说明
STATUS_SUCCESS
 函数成功。
STATUS_INVALID_PARAMETER
 一个或多个参数无效。
STATUS_NO_MEMORY
 内存分配失败。

注解

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

要求

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

另请参阅

CRYPT_CONTEXT_FUNCTION_CONFIG