SslComputeClientAuthHash 函式

SslComputeClientAuthHash函式會計算憑證驗證期間要使用的雜湊。

語法

SECURITY_STATUS WINAPI SslComputeClientAuthHash(
  _In_  NCRYPT_PROV_HANDLE hSslProvider,
  _In_  NCRYPT_KEY_HANDLE  hMasterKey,
  _In_  NCRYPT_HASH_HANDLE hHandshakeHash,
  _In_  LPCWSTR            pszAlgId,
  _Out_ PBYTE              pbOutput,
  _In_  DWORD              cbOutput,
  _Out_ DWORD              *pcbResult,
  _In_  DWORD              dwFlags
);

參數

hSslProvider [in]

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

hMasterKey [in]

主要金鑰物件的控制碼。

hHandshakeHash [in]

到目前為止計算之交握雜湊的控制碼。

pszAlgId [in]

以 Null 終止的 Unicode 字串指標，識別所要求的 密碼編譯演算法。 這可以是其中一個標準 CNG 演算法識別碼 ，或是另一個已註冊演算法的識別碼。

pbOutput [out]

接收 金鑰 BLOB的緩衝區位址。 cbOutput參數包含這個緩衝區的大小。 如果此參數為Null，則此函式會將所需的大小，以位元組為單位，放在由 azureResult參數所指向的DWORD中。

cbOutput [in]

pbOutput緩衝區的長度，以位元組為單位。

azureResult [out]

DWORD值的指標，指定寫入pbOutput緩衝區之雜湊的長度，以位元組為單位。

dwFlags [in]

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

傳回值

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

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

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

傳回碼/值	Description
NTE_INVALID_HANDLE 0x80090026L	其中一個提供的控制碼無效。

備註

SslComputeClientAuthHash函式會計算 SSL 交握憑證驗證訊息中傳送的雜湊。 雜湊值是藉由建立包含主要密碼的雜湊，其中包含所有先前傳送或接收交握訊息的雜湊來計算。

雜湊的計算方式取決於所使用的通訊協定和加密套件。 此外，雜湊取決於使用的用戶端驗證金鑰類型; pszAlgId 參數指出用於用戶端驗證的金鑰類型。

規格需求

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