SslCreateClientAuthHash 函式

  • 發行項

SslCreateClientAuthHash函式會擷取用於用戶端驗證的交握雜湊控制碼。

語法

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

參數

hSslProvider [in]

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

phHandshakeHash [out]

要接收雜湊控制碼 之NCRYPT_HASH_HANDLE 變數的指標。

dwProtocol [in]

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

dwCipherSuite [in]

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

pszHashAlgId [in]

其中一個 CNG 演算法識別碼 值。

dwFlags [in]

此參數保留供日後使用，且必須設定為零。

傳回值

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

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

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

傳回碼/值 Description
NTE_INVALID_HANDLE
0x80090026L
 hSslProvider參數包含不正確指標。
NTE_INVALID_PARAMETER
0x80090027L
 phHandshakeHash參數設定為Null。
NTE_NOT_SUPPORTED
0x80090029L
 指定的介面版本不支援選取的函式。
NTE_NO_MEMORY
0x8009000EL
 記憶體不足，無法配置緩衝區。
NTE_BAD_FLAGS
0x80090009L
 dwFlags參數必須設定為零。

備註

針對傳輸層安全性通訊協定 (TLS) 1.2 或更新版本的交談呼叫SslCreateClientAuthHash函式，以建立用來雜湊交握訊息的雜湊物件。 它會針對可用於用戶端驗證簽章的每個可能 雜湊演算法 呼叫一次。

規格需求

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