CryptHashToBeSigned 函式 (wincrypt.h)

  • 發行項
重要 此 API 已被取代。 新的和現有的軟體應該開始使用 密碼編譯新一代 API。 Microsoft 可能會在未來的版本中移除此 API。
 
CryptHashToBeSigned函式會從已簽署和編碼的憑證計算編碼內容的雜湊。 雜湊只會在「要簽署」編碼的內容及其簽章上執行。

語法

BOOL CryptHashToBeSigned(
  [in]      HCRYPTPROV_LEGACY hCryptProv,
  [in]      DWORD             dwCertEncodingType,
  [in]      const BYTE        *pbEncoded,
  [in]      DWORD             cbEncoded,
  [out]     BYTE              *pbComputedHash,
  [in, out] DWORD             *pcbComputedHash
);

參數

[in] hCryptProv

不會使用此參數，而且應該設定為 Null。

Windows Server 2003 和 Windows XP： 用來計算雜湊的密碼 編譯服務提供者 (CSP) 控制碼。此參數的資料類型為 HCRYPTPROV。

除非有在 hCryptProv中傳入特定密碼編譯提供者的強原因，否則會傳入零。 傳入零會導致在進行雜湊、簽章驗證或收件者加密作業之前，先取得預設RSA或數位簽章標準 (DSS) 提供者。

[in] dwCertEncodingType

指定所使用的編碼類型。 將 憑證 和 訊息編碼類型 與位OR 作業結合在一起，一律可以接受，如下列範例所示：

X509_ASN_ENCODING |PKCS_7_ASN_ENCODING

目前定義的編碼類型如下：

  • X509_ASN_ENCODING
  • PKCS_7_ASN_ENCODING

[in] pbEncoded

緩衝區的位址，其中包含要雜湊的內容。 這是 CERT_SIGNED_CONTENT_INFO的編碼形式。

[in] cbEncoded

緩衝區的大小 (以位元組為單位)。

[out] pbComputedHash

要接收計算雜湊之緩衝區的指標。

此參數可以是 Null ，可設定此資訊的大小以供記憶體配置之用。 如需詳細資訊，請參閱 擷取未知長度的資料。

[in, out] pcbComputedHash

DWORD的指標，其中包含pbComputedHash參數所指向之緩衝區的大小，以位元組為單位。 當函式傳回時， DWORD 會包含儲存在緩衝區中的位元組數目。

注意 處理緩衝區中傳回的資料時，應用程式必須使用傳回之資料的實際大小。 實際大小可能會稍微小於輸入中指定的緩衝區大小。 在輸入時，緩衝區大小通常會指定夠大，以確保最大可能的輸出資料會放入緩衝區中。 在輸出時，會更新此參數所指向的變數，以反映複製到緩衝區的資料實際大小。
 

傳回值

如果函式成功，函式會傳回非零 (TRUE) 。

如果函式失敗，它會傳回零 (FALSE) 。 如需擴充的錯誤資訊，請呼叫 GetLastError。

注意 來自所呼叫函式 CryptCreateHash、 CryptGetHashParam和 CryptHashData 的錯誤可能會傳播至此函式。 此函式具有下列錯誤碼。
 
傳回碼 描述
ERROR_MORE_DATA
 如果 pbComputedHash 參數指定的緩衝區不夠大，無法保存傳回的資料，函式會設定ERROR_MORE_DATA程式碼，並將所需的緩衝區大小以位元組為單位儲存到 由edHash指向的變數中。
ERROR_FILE_NOT_FOUND
 憑證編碼類型無效。 目前僅支援X509_ASN_ENCODING。
NTE_BAD_ALGID
 簽章演算法 (OID) 的物件識別碼 不會對應至已知或支援的雜湊演算法。
 

如果函式失敗， GetLastError 可能會傳回 抽象語法標記法 1 (ASN.1) 編碼/解碼錯誤。 如需這些錯誤的相關資訊，請參閱 ASN.1 編碼/解碼傳回值。

規格需求

   
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 wincrypt.h
程式庫 Crypt32.lib
Dll Crypt32.dll

另請參閱

CryptHashCertificate

CryptHashPublicKeyInfo

資料管理函式