BCryptAddContextFunction 函数 (bcrypt.h)

  • 项目

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

BCryptAddContextFunction 函数将加密函数添加到现有 CNG 上下文支持的函数列表中。

语法

NTSTATUS BCryptAddContextFunction(
  [in] ULONG   dwTable,
  [in] LPCWSTR pszContext,
  [in] ULONG   dwInterface,
  [in] LPCWSTR pszFunction,
  [in] ULONG   dwPosition
);

参数

[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] dwPosition

指定列表中插入此函数的位置。 函数将插入到任何现有函数之前此位置。 CRYPT_PRIORITY_TOP值用于在列表顶部插入函数。 CRYPT_PRIORITY_BOTTOM值用于在列表末尾插入函数。

返回值

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

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

返回代码 说明
STATUS_SUCCESS
 函数成功。
STATUS_INVALID_PARAMETER
 一个或多个参数无效。
STATUS_NO_MEMORY
 内存分配失败。
STATUS_NOT_FOUND
 找不到上下文。

注解

如果添加的函数已在列表中，则会将其删除并插入到新位置。

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

要求

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

另请参阅

BCryptRemoveContextFunction