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]

這個參數保留給未來使用。

傳回值

如果函式成功，則會傳回零。

如果函式失敗，它會傳回非零的錯誤值。

可能的傳回碼包括但不限於下列專案。

傳回碼/值	Description
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