CryptDecodeMessage 函式 (wincrypt.h)
CryptDecodeMessage 函式會譯碼、解密及驗證密碼編譯訊息。
當密碼編譯訊息的類型未知時，可以使用此函式。 dwMsgTypeFlags 常數可以與位 OR 運算結合，讓函式嘗試尋找其中一個類型。 找到其中一個類型時，函式會報告找到的類型，並傳回適合該類型的數據。
在每個階段中，函式只會破解單一層級的加密或編碼。 若要進行其他破解，必須再次呼叫此函式或其他簡化 訊息函式。
語法
BOOL CryptDecodeMessage(
[in] DWORD dwMsgTypeFlags,
[in] PCRYPT_DECRYPT_MESSAGE_PARA pDecryptPara,
[in] PCRYPT_VERIFY_MESSAGE_PARA pVerifyPara,
[in] DWORD dwSignerIndex,
[in] const BYTE *pbEncodedBlob,
[in] DWORD cbEncodedBlob,
[in] DWORD dwPrevInnerContentType,
[out, optional] DWORD *pdwMsgType,
[out, optional] DWORD *pdwInnerContentType,
[out, optional] BYTE *pbDecoded,
[in, out, optional] DWORD *pcbDecoded,
[out, optional] PCCERT_CONTEXT *ppXchgCert,
[out, optional] PCCERT_CONTEXT *ppSignerCert
);
參數
[in] dwMsgTypeFlags
指出訊息類型。 訊息類型可以與位 OR 運算子結合。 此參數可以是下列其中一種訊息類型：
- CMSG_DATA_FLAG
- CMSG_SIGNED_FLAG
- CMSG_ENVELOPED_FLAG
- CMSG_SIGNED_AND_ENVELOPED_FLAG
- CMSG_HASHED_FLAG
[in] pDecryptPara
包含解密參數 之CRYPT_DECRYPT_MESSAGE_PARA 結構的指標。
[in] pVerifyPara
包含驗證參數 之CRYPT_VERIFY_MESSAGE_PARA 結構的指標。
[in] dwSignerIndex
指出要驗證訊息的可能許多簽署者之間的簽署者。 此索引可以在函式的多個呼叫中變更，以驗證其他簽署者。
dwSignerIndex 會針對第一個簽署者設定為零。 如果函式傳回 FALSE，而 GetLastError 傳回CRYPT_E_NO_SIGNER，則先前的呼叫會傳回訊息的最後一個簽署者。 此參數只適用於類型CMSG_SIGNED_AND_ENVELOPED或CMSG_SIGNED的訊息。 對於所有其他訊息類型，它應該設定為零。
[in] pbEncodedBlob
要譯碼之編碼 BLOB 的指標。
[in] cbEncodedBlob
編碼 BLOB 的大小，以位元組為單位。
[in] dwPrevInnerContentType
只有在處理巢狀密碼編譯訊息時才適用。 處理外部密碼編譯訊息時，它必須設定為零。 譯碼巢狀密碼編譯訊息時，它會由先前呼叫外部訊息的 CryptDecodeMessage，設定為 pdwInnerContentType 傳回的值。 它可以是 pdwMsgType 中列出的任何 CMSG 類型。 為了回溯相容性，請將 dwPrevInnerContentType 設定為零。
[out, optional] pdwMsgType
指定傳回之訊息類型的 DWORD 指標。 此參數可以是下列其中一種訊息類型：
- CMSG_DATA
- CMSG_SIGNED
- CMSG_ENVELOPED
- CMSG_SIGNED_AND_ENVELOPED
- CMSG_HASHED
[out, optional] pdwInnerContentType
指定內部訊息類型的 DWORD 指標。 這裡也會使用 pdwMsgType 所使用的訊息類型代碼。
如果沒有密碼編譯巢狀，則會傳回CMSG_DATA。
[out, optional] pbDecoded
要接收譯碼訊息之緩衝區的指標。
如果不需要譯碼的訊息，或為記憶體配置目的設定譯碼訊息的大小，這個參數可以是 NULL 。 如果此參數為 NULL，將不會傳回譯碼的訊息。 如需詳細資訊，請參閱 擷取未知長度的數據。
[in, out, optional] pcbDecoded
變數的指標，指定 pbDecoded 參數所指向之緩衝區的大小，以位元組為單位。 當函式傳回時，此變數會包含譯碼訊息的大小。
[out, optional] ppXchgCert
指向 CERT_CONTEXT 結構的指標，其中包含對應至譯碼 訊息所需的私鑰 的憑證。 此參數僅適用於訊息類型CMSG_ENVELOPED和CMSG_SIGNED_AND_ENVELOPED。
[out, optional] ppSignerCert
簽署者憑證內容之CERT_CONTEXT結構的指標。 此參數僅適用於訊息類型CMSG_SIGNED和CMSG_SIGNED_AND_ENVELOPED。
傳回值
如果函式成功，函式會傳回非零 (TRUE) 。
如果函式失敗，它會傳回零 (FALSE) 。 如需擴充錯誤資訊，請呼叫 GetLastError。
CryptDecryptMessage、CryptVerifyMessageSignature 或 CryptVerifyMessageHash 函式可以傳播至此函式。
下列錯誤碼最常由 GetLastError 函式傳回。
| 傳回碼 | Description |
|---|---|
|
如果 pbDecoded 參數指定的緩衝區不夠大，無法保存傳回的數據，則函式會設定ERROR_MORE_DATA程式代碼，並以位元組為單位來儲存 所指向的變數中所需的緩衝區大小。 |
備註
dwMsgTypeFlags 參數會指定一組允許的訊息。 例如，若要譯碼 SIGNED 或 ENVELOPED 訊息，請將 dwMsgTypeFlags 設定為 CMSG_SIGNED_FLAG |CMSG_ENVELOPED_FLAG。 必須指定 pDecryptPara 或 pVerifyPara 參數的或兩者。
針對成功譯碼或驗證的訊息，會更新 ppXchgCert 和 ppSignerCert 所指向的憑證內容指標。 您必須呼叫 CertFreeCertificateContext 來釋放它們。 如果函式失敗，它們會設定為 NULL。
呼叫函式之前， ppXchgCert 或 ppSignerCert 參數可以設定為 NULL ，這表示呼叫端對取得交換憑證或簽署者 憑證內容不感興趣。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | wincrypt.h |
| 程式庫 | Crypt32.lib |
| Dll | Crypt32.dll |