NCryptIsAlgSupported 函数 (ncrypt.h)

  • 项目

NCryptIsAlgSupported 函数确定 CNG 密钥存储提供程序是否支持特定的加密算法。

语法

SECURITY_STATUS NCryptIsAlgSupported(
  [in] NCRYPT_PROV_HANDLE hProvider,
  [in] LPCWSTR            pszAlgId,
  [in] DWORD              dwFlags
);

参数

[in] hProvider

密钥存储提供程序的句柄。 此句柄是通过 NCryptOpenStorageProvider 函数获取的。

[in] pszAlgId

指向以 null 结尾的 Unicode 字符串的指针，该字符串标识有问题的加密算法。 这可以是标准 CNG 算法标识符 之一，也可以是另一个已注册算法的标识符。

[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_NOT_SUPPORTED
 提供程序不支持指定的算法。

注解

如果提供程序支持算法，则此函数将返回 ERROR_SUCCESS。 如果提供程序不支持该算法，并且没有发生其他错误，则此函数将返回 NTE_NOT_SUPPORTED。

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

要求

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