CryptHashData 函式 (wincrypt.h)

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

CryptHashData 函式會將數據新增至指定的哈希物件。此函式和 CryptHashSessionKey 可以多次呼叫，以計算長數據流或不連續數據流的哈希。

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

語法

BOOL CryptHashData(
  [in] HCRYPTHASH hHash,
  [in] const BYTE *pbData,
  [in] DWORD      dwDataLen,
  [in] DWORD      dwFlags
);

[in] hHash

哈希物件的句柄。

[in] pbData

緩衝區的指標，其中包含要加入至哈希對象的數據。

[in] dwDataLen

要加入的數據位元組數目。如果已設定CRYPT_USERDATA旗標，這必須是零。

[in] dwFlags

定義下列旗標值。

值	意義
CRYPT_OWF_REPL_LM_HASH 0x00000001	未使用此旗標。
CRYPT_USERDATA 1 (0x1)	所有 Microsoft 密碼編譯提供者都會忽略此參數。對於未忽略此參數的任何 CSP，如果已設定此旗標，CSP 會提示使用者直接輸入數據。此數據會新增至哈希。應用程式不允許存取數據。此旗標可用來允許使用者在系統中輸入 PIN。

如果函式成功，則傳回值為 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_LEN	CSP 不會忽略CRYPT_USERDATA旗標、已設定旗標，且 dwDataLen 參數具有非零值。
NTE_BAD_UID	找不到建立哈希物件時所指定的 CSP 內容。
NTE_FAIL	函式以非預期的方式失敗。
NTE_NO_MEMORY	CSP 在作業期間記憶體不足。