通过

BCryptQueryContextConfiguration 函数 (bcrypt.h)

  • 项目

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

BCryptQueryContextConfiguration 函数检索指定 CNG 上下文的当前配置。

语法

NTSTATUS BCryptQueryContextConfiguration(
  [in]      ULONG                 dwTable,
  [in]      LPCWSTR               pszContext,
  [in, out] ULONG                 *pcbBuffer,
  [in, out] PCRYPT_CONTEXT_CONFIG *ppBuffer
);

参数

[in] dwTable

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

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

[in] pszContext

指向以 null 结尾的 Unicode 字符串的指针，该字符串包含要获取其配置信息的上下文的标识符。

[in, out] pcbBuffer

输入时包含 ppBuffer 指向的缓冲区的大小（以字节为单位）的 ULONG 变量的地址。 如果此大小不足以保存上下文信息，则此函数将失败并 出现STATUS_BUFFER_TOO_SMALL。

此函数返回后，此变量包含复制到 ppBuffer 缓冲区的字节数。

[in, out] ppBuffer

指向接收此函数检索的上下文配置信息的 CRYPT_CONTEXT_CONFIG 结构的指针的地址。 由号Buffer 参数指向的值包含此缓冲区的大小。

如果此参数指向的值为 NULL，则此函数将分配所需的内存。 当不再需要此内存时，必须通过将此指针传递给 BCryptFreeBuffer 函数来释放此内存。

如果此参数为 NULL，则此函数会将所需大小（以字节为单位）放在由STATUS_BUFFER_TOO_SMALL指向的变量中。

有关此参数用法的详细信息，请参阅备注。

返回值

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

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

返回代码 说明
STATUS_SUCCESS
 函数成功。
STATUS_BUFFER_TOO_SMALL
 ppBuffer 参数不是 NULL，并且由印刷板Buffer 参数指向的值不够大，无法容纳上下文集。
STATUS_INVALID_PARAMETER
 一个或多个参数无效。
STATUS_NO_MEMORY
 内存分配失败。
STATUS_NOT_FOUND
 找不到指定的上下文。

注解

每个上下文只有一组配置信息，因此，尽管 ppBuffer 参数似乎是用作数组的 ，但此函数将其视为只有一个元素的数组。 以下示例有助于阐明如何使用此参数。

// Get the configuration information for the context.
CRYPT_CONTEXT_CONFIG config;
ULONG uSize = sizeof(config);
PCRYPT_CONTEXT_CONFIG pConfig = &config;
status = BCryptQueryContextConfiguration(
    CRYPT_LOCAL, 
    pszContextID, 
    &uSize, 
    &pConfig);

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

要求

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