SslGenerateSessionKeys 函数

SslGenerateSessionKeys 函数生成一组安全套接字层协议， (SSL) 会话密钥。

语法

SECURITY_STATUS WINAPI SslGenerateSessionKeys(
  _In_  NCRYPT_PROV_HANDLE hSslProvider,
  _In_  NCRYPT_KEY_HANDLE  hMasterKey,
  _Out_ NCRYPT_KEY_HANDLE  *phReadKey,
  _Out_ NCRYPT_KEY_HANDLE  *phWriteKey,
  _In_  PNCryptBufferDesc  pParameterList,
  _In_  DWORD              dwFlags
);

参数

hSslProvider [in]

SSL 协议提供程序实例的句柄。

hMasterKey [in]

主密钥对象的句柄。

phReadKey [out]

指向返回的读取键句柄的指针。

phWriteKey [out]

指向返回的写入键句柄的指针。

pParameterList [in]

指向 NCryptBuffer 缓冲区数组的指针，该数组包含用作密钥交换操作一部分的信息。 精确的缓冲区集取决于所使用的协议和密码套件。 列表中至少包含包含客户端和服务器提供的随机值的缓冲区。

dwFlags [in]

此参数留待将来使用。

返回值

如果该函数成功，则返回零。

如果函数失败，它将返回非零错误值。

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

返回代码/值	说明
NTE_NO_MEMORY 0x8009000EL	内存不足，无法分配必要的缓冲区。
NTE_INVALID_HANDLE 0x80090026L	提供的句柄之一无效。
NTE_INVALID_PARAMETER 0x80090027L	phReadKey 或 phWriteKey 参数为 null。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
标头	Sslprovider.h
DLL	Ncrypt.dll