共用方式為

SslCreateHandshakeHash 函式

  • 發行項

SslCreateHandshakeHash函式會取得用來雜湊交握訊息的雜湊控制碼。

語法

SECURITY_STATUS WINAPI SslCreateHandshakeHash(
  _In_  NCRYPT_PROV_HANDLE hSslProvider,
  _Out_ NCRYPT_HASH_HANDLE *phHandshakeHash,
  _In_  DWORD              dwProtocol,
  _In_  DWORD              dwCipherSuite,
  _In_  DWORD              dwFlags
);

參數

hSslProvider [in]

安全通訊端層通訊協定的控制碼 (SSL) 通訊協定提供者實例。

phHandshakeHash [out]

可以傳遞至其他 SSL 提供者函式的雜湊控制碼。

dwProtocol [in]

其中一個 CNG SSL 提供者通訊協定識別碼 值。

注意

此函式不會與 SSL 2.0 通訊協定搭配使用。

dwCipherSuite [in]

其中一個 CNG SSL 提供者加密套件識別碼 值。

dwFlags [in]

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

傳回值

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

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

可能的傳回碼包括但不限於下列各項。

傳回碼/值 Description
NTE_NO_MEMORY
0x8009000EL
 記憶體不足，無法配置雜湊緩衝區。
NTE_INVALID_HANDLE
0x80090026L
 hSslProvider控制碼無效。
NTE_INVALID_PARAMETER
0x80090027L
 phHandshakeHash為 null。

備註

SslCreateHandshakeHash函式是用來在 SSL 交握期間產生雜湊的三個函式之一。

  1. 會呼叫 SslCreateHandshakeHash函式以取得雜湊控制碼。
  2. SslHashHandshake函式會呼叫雜湊控制碼以將資料新增至雜湊的任何次數。
  3. 使用雜湊控制碼呼叫 SslComputeFinishedHash 函式，以取得雜湊資料的摘要。

規格需求

需求 值
最低支援的用戶端
 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器
 Windows Server 2008 [僅限傳統型應用程式]
標頭
Sslprovider.h
DLL
Ncrypt.dll