NCryptEnumAlgorithms 函数 (ncrypt.h)

  • 项目

NCryptEnumAlgorithms 函数获取指定密钥存储提供程序支持的算法的名称。

语法

SECURITY_STATUS NCryptEnumAlgorithms(
  [in]  NCRYPT_PROV_HANDLE  hProvider,
  [in]  DWORD               dwAlgOperations,
  [out] DWORD               *pdwAlgCount,
  [out] NCryptAlgorithmName **ppAlgList,
  [in]  DWORD               dwFlags
);

参数

[in] hProvider

要枚举其算法的密钥存储提供程序的句柄。 此句柄是通过 NCryptOpenStorageProvider 函数获取的。

[in] dwAlgOperations

一组值，用于确定要枚举的算法类。 这可以是零，也可以是以下一个或多个值的组合。 如果 dwAlgOperations 为零，则枚举所有算法。

值 含义
NCRYPT_CIPHER_OPERATION
0x00000001
 枚举 (对称加密) 算法的密码。
NCRYPT_HASH_OPERATION
0x00000002
 枚举哈希算法。
NCRYPT_ASYMMETRIC_ENCRYPTION_OPERATION
0x00000004
 枚举非对称加密算法。
NCRYPT_SECRET_AGREEMENT_OPERATION
0x00000008
 枚举机密协议算法。
NCRYPT_SIGNATURE_OPERATION
0x00000010
 枚举数字签名算法。

[out] pdwAlgCount

接收 ppAlgList 数组中元素数的 DWORD 的地址。

[out] ppAlgList

接收已注册算法名称数组的 NCryptAlgorithmName 结构指针的地址。 pdwAlgCount 参数指向的变量接收此数组中的元素数。

当不再需要此内存时，必须通过将此指针传递给 NCryptFreeBuffer 函数来释放该内存。

[in] dwFlags

用于修改函数行为的标志。 此值可以是零 (0) 或以下值。

值 含义
NCRYPT_SILENT_FLAG
 请求关键服务提供程序 (KSP) 不显示任何用户界面。 如果提供程序必须显示 UI 才能操作，则调用将失败，KSP 应将 NTE_SILENT_CONTEXT 错误代码设置为最后一个错误。

返回值

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

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

返回代码 说明
ERROR_SUCCESS
 函数成功。
NTE_BAD_FLAGS
 dwFlags 参数包含无效的值。
NTE_INVALID_HANDLE
 hProvider 参数无效。
NTE_INVALID_PARAMETER
 一个或多个参数无效。
NTE_NO_MEMORY
 内存分配失败。

注解

服务不得从其 StartService 函数调用此函数。 如果服务从其 StartService 函数调用此函数，则可能会出现死锁，并且服务可能会停止响应。

要求

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