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) 或以下值。
值 | 含义 |
---|---|
|
请求关键服务提供程序 (KSP) 不显示任何用户界面。 如果提供程序必须显示 UI 才能操作,则调用将失败,KSP 应将 NTE_SILENT_CONTEXT 错误代码设置为最后一个错误。 |
返回值
返回指示函数成功或失败的状态代码。
可能的返回代码包括但不限于以下内容。
返回代码 | 说明 |
---|---|
|
提供程序支持指定的算法。 |
|
dwFlags 参数包含一个或多个不支持的标志。 |
|
由 hProvider 参数指定的句柄无效。 |
|
一个或多个参数无效。 |
|
提供程序不支持指定的算法。 |
注解
如果提供程序支持算法,则此函数将返回 ERROR_SUCCESS。 如果提供程序不支持该算法,并且没有发生其他错误,则此函数将返回 NTE_NOT_SUPPORTED。
服务不得从其 StartService 函数调用此函数。 如果服务从其 StartService 函数调用此函数,则可能会出现死锁,并且服务可能会停止响应。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [桌面应用 | UWP 应用] |
最低受支持的服务器 | Windows Server 2008 [桌面应用 | UWP 应用] |
目标平台 | Windows |
标头 | ncrypt.h |
Library | Ncrypt.lib |
DLL | Ncrypt.dll |