CryptDecryptAndVerifyMessageSignature

CryptDecryptAndVerifyMessageSignature 関数は、メッセージを復号し署名を検証する。

CryptDecryptAndVerifyMessageSignature pDecryptPara, pVerifyPara, dwSignerIndex, pbEncryptedBlob, cbEncryptedBlob, pbDecrypted, pcbDecrypted, ppXchgCert, ppSignerCert

pDecryptPara : [var] 復号パラメータを含む CRYPT_DECRYPT_MESSAGE_PARA 構造体へのポインタ。
pVerifyPara : [var] 検証パラメータを含む CRYPT_VERIFY_MESSAGE_PARA 構造体へのポインタ。
dwSignerIndex : [int] メッセージの特定の署名者を識別する。メッセージは複数の署名者によって署名されることがあり、このパラメータを変更しながらこの関数を複数回呼び出して複数の署名者を確認できる。最初の署名者では 0 に設定する。関数が FALSE を返し、GetLastError が CRYPT_E_NO_SIGNER を返す場合、前回の呼び出しでメッセージの最後の署名者を受け取ったことを示す。
pbEncryptedBlob : [var] 復号および検証を行う署名・符号化・暗号化されたメッセージへのポインタ。
cbEncryptedBlob : [int] 暗号化メッセージのサイズ (バイト単位)。
pbDecrypted : [var] 復号されたメッセージを受け取るバッファへのポインタ。
pcbDecrypted : [var] pbDecrypted パラメータが指すバッファのサイズ (バイト単位) を指定する DWORD へのポインタ。関数が戻ると、pbDecrypted にコピーされた復号済みメッセージのサイズが格納される。
ppXchgCert : [var] メッセージを復号するために必要な秘密鍵交換鍵に対応する証明書を表す CERT_CONTEXT 構造体へのポインタ。
ppSignerCert : [var] 署名者の証明書を表す CERT_CONTEXT 構造体へのポインタ。

(プラグイン / モジュール : crypt32.dll)

解説

CryptDecryptAndVerifyMessageSignature 関数は、メッセージを復号し署名を検証する。

[戻り値]
関数が成功した場合、戻り値は 0 以外 (TRUE)。関数が失敗した場合は 0 (FALSE) を返す。拡張エラー情報を取得するには
GetLastError を呼び出す。注意 呼び出された CryptDecryptMessage および
CryptVerifyMessageSignature 関数のエラーがこの関数に伝播することがある。GetLastError
関数は最も一般的に次のエラーコードを返す。
（以下省略）

[備考]
メッセージの復号および検証に成功すると、ppXchgCert および ppSignerCert
が指す証明書コンテキストポインタが更新される。これらは CertFreeCertificateContext
を呼び出して解放しなければならない。関数が失敗した場合、これらは NULL
に設定される。呼び出し元が交換証明書や署名者証明書コンテキストに関心がないことを示すには、ppXchgCert および
ppSignerCert パラメータを NULL に設定する。

情報