CryptDecodeMessage 関数 (wincrypt.h)

CryptDecodeMessage 関数は、暗号化メッセージをデコード、復号化、検証します。

この関数は、暗号化メッセージの種類が不明な場合に使用できます。 dwMsgTypeFlags 定数をビットごとの OR 演算と組み合わせて、関数がいずれかの型を検索できるようにします。 いずれかの型が見つかると、関数は検出された型を報告し、その型に適したデータを返します。

各パスでは、関数は単一レベルの暗号化またはエンコードのみを割り込みます。 さらにクラッキングを行うには、この関数または他の 簡易メッセージ関数の 1 つを再度呼び出す必要があります。

構文

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 は、最初の署名者に対して 0 に設定されます。 関数が FALSE を返し、 GetLastError が CRYPT_E_NO_SIGNERを返した場合、前の呼び出しはメッセージの最後の署名者を返しました。 このパラメーターは、CMSG_SIGNED_AND_ENVELOPEDまたはCMSG_SIGNED型のメッセージでのみ使用されます。 他のすべてのメッセージの種類では、0 に設定する必要があります。

[in] pbEncodedBlob

デコードされるエンコードされた BLOB へのポインター。

[in] cbEncodedBlob

エンコードされた BLOB のサイズ (バイト単位)。

[in] dwPrevInnerContentType

入れ子になった暗号化メッセージを処理する場合にのみ適用されます。 外部暗号化メッセージを処理する場合は、0 に設定する必要があります。 入れ子になった暗号化メッセージをデコードする場合、外部メッセージの CryptDecodeMessage の以前の呼び出しによって pdwInnerContentType で返される値に設定されます。 pdwMsgType にリストされている CMSG タイプのいずれかを指定できます。 下位互換性を保つために、 dwPrevInnerContentType を 0 に設定します。

[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にのみ設定されます。

戻り値

関数が成功した場合、関数は 0 以外 (TRUE) を返します。

関数が失敗した場合は、0 (FALSE) を返します。 拡張エラー情報については、 GetLastError を呼び出します。

CryptDecryptMessage、CryptVerifyMessageSignature、または CryptVerifyMessageHash 関数をこの関数に反映できます。

次のエラー コードは、 GetLastError 関数によって最も一般的に返されます。

注釈

dwMsgTypeFlags パラメーターは、許容されるメッセージのセットを指定します。 たとえば、SIGNED メッセージまたは ENVELOPED メッセージをデコードするには、 dwMsgTypeFlags を CMSG_SIGNED_FLAG | に設定します。CMSG_ENVELOPED_FLAG。 pDecryptPara パラメーターまたは pVerifyPara パラメーターのいずれかまたは両方を指定する必要があります。

正常にデコードまたは検証されたメッセージの場合、ppXchgCert と ppSignerCert が指す証明書コンテキスト ポインターが更新されます。 CertFreeCertificateContext を呼び出して解放する必要があります。 関数が失敗した場合は、 NULL に設定されます。

関数が呼び出される前に 、ppXchgCert パラメーターまたは ppSignerCert パラメーターを NULL に設定できます。これは、呼び出し元が Exchange 証明書または署名者 証明書コンテキストの取得に関心を持たないことを示します。

要件

こちらもご覧ください

CryptDecryptMessage

CryptVerifyMessageHash

CryptVerifyMessageSignature

簡略化されたメッセージ関数