Share via

BCryptCreateContext 函数 (bcrypt.h)

  • 项目

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

BCryptCreateContext 函数创建新的 CNG 配置上下文。

语法

NTSTATUS BCryptCreateContext(
  [in]           ULONG                 dwTable,
  [in]           LPCWSTR               pszContext,
  [in, optional] PCRYPT_CONTEXT_CONFIG pConfig
);

参数

[in] dwTable

标识要创建上下文的配置表。 这可以是以下值之一。

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

[in] pszContext

指向以 null 结尾的 Unicode 字符串的指针，该字符串包含要创建的上下文的标识符。

[in, optional] pConfig

指向包含新上下文的其他配置数据的 CRYPT_CONTEXT_CONFIG 结构的指针。 如果不需要此参数，可以为 NULL 。

返回值

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

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

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

注解

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

要求

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