CryptHashSessionKey 函式 (wincrypt.h)

重要此 API 已被取代。新的和現有的軟體應該開始使用密碼編譯新一代 API。 Microsoft 可能會在未來的版本中移除此 API。

CryptHashSessionKey 函式會計算會話密鑰物件的密碼編譯哈希。您可以使用相同的哈希句柄多次呼叫此函式，以計算多個索引鍵的哈希。對 CryptHashSessionKey 的呼叫可以與對 CryptHashData 的呼叫交錯。

呼叫此函式之前，必須先呼叫 CryptCreateHash ，才能建立哈希物件的句柄。

語法

BOOL CryptHashSessionKey(
  [in] HCRYPTHASH hHash,
  [in] HCRYPTKEY  hKey,
  [in] DWORD      dwFlags
);

[in] hHash

[in] hKey

要哈希之索引鍵物件的句柄。

[in] dwFlags

定義下列旗標值。

值	意義
CRYPT_LITTLE_ENDIAN 0x00000001	設定此旗標時，索引鍵的位元組會以小端形式哈希。請注意，根據預設 (，當 dwFlags 為零) 時，索引鍵的位元組會以大端格式哈希。

如果函式成功，則傳回值為 TRUE。

如果函式失敗，則傳回值為 FALSE。如需擴充錯誤資訊，請呼叫 GetLastError。

“NTE” 開頭的錯誤碼是由您使用的特定 CSP 所產生。以下是一些可能的錯誤碼。

傳回碼	Description
ERROR_INVALID_HANDLE	其中一個參數指定無效的句柄。
ERROR_INVALID_PARAMETER	其中一個參數包含無效的值。這通常是無效的指標。
NTE_BAD_ALGID	hHash 句柄指定此 CSP 不支持的演算法。
NTE_BAD_FLAGS	dwFlags 參數為非零。
NTE_BAD_HASH	hHash 參數指定的哈希對象無效。
NTE_BAD_HASH_STATE	嘗試將數據新增至已標示為「已完成」的哈希物件。
NTE_BAD_KEY	正在使用金鑰哈希演算法，但會話密鑰已不再有效。如果在哈希作業完成之前終結會話密鑰，就會產生此錯誤。
NTE_BAD_UID	找不到建立哈希物件時所指定的 CSP 內容。
NTE_FAIL	函式以非預期的方式失敗。