通过

NCryptSecretAgreement 函数 (ncrypt.h)

  • 项目

NCryptSecretAgreement 函数从私钥和公钥创建机密协议值。

语法

SECURITY_STATUS NCryptSecretAgreement(
  [in]  NCRYPT_KEY_HANDLE    hPrivKey,
  [in]  NCRYPT_KEY_HANDLE    hPubKey,
  [out] NCRYPT_SECRET_HANDLE *phAgreedSecret,
  [in]  DWORD                dwFlags
);

参数

[in] hPrivKey

用于创建机密协议值的 私钥 的句柄。 此密钥和 hPubKey 密钥必须来自同一密钥存储提供程序。

[in] hPubKey

用于创建机密协议值的 公钥 的句柄。 此密钥和 hPrivKey 密钥必须来自同一密钥存储提供程序。

[out] phAgreedSecret

指向 NCRYPT_SECRET_HANDLE 变量的指针，该变量接收表示机密协议值的句柄。 如果不再需要此句柄，请将其传递给 NCryptFreeObject 函数来释放它。

[in] dwFlags

用于修改函数行为的标志。 这可以是零，也可以是以下一个或多个值的组合。 有效标志集特定于每个密钥存储提供程序。 以下标志适用于所有提供程序。

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

返回值

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

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

返回代码 说明
ERROR_SUCCESS
 函数成功。
NTE_INVALID_HANDLE
 hPrivKey 或 hPubKey 参数无效。
NTE_INVALID_PARAMETER
 一个或多个参数无效。
NTE_NO_MEMORY
 内存分配失败。

注解

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

要求

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

另请参阅

NCryptFreeObject