CryptDecryptMessage

CryptDecryptMessage 関数はメッセージを復号化および復号する。

CryptDecryptMessage pDecryptPara, pbEncryptedBlob, cbEncryptedBlob, pbDecrypted, pcbDecrypted, ppXchgCert

pDecryptPara : [var] 復号パラメータを含む CRYPT_DECRYPT_MESSAGE_PARA 構造体へのポインタ。
pbEncryptedBlob : [var] 復号する符号化・暗号化されたメッセージを含むバッファへのポインタ。
cbEncryptedBlob : [int] 符号化・暗号化されたメッセージのサイズ (バイト単位)。
pbDecrypted : [var] 復号されたメッセージを受け取るバッファへのポインタ。
pcbDecrypted : [var] pbDecrypted パラメータが指すバッファのサイズ (バイト単位) を指定する DWORD へのポインタ。関数が戻ると、この変数は pbDecrypted にコピーされた復号済みメッセージのサイズ (バイト単位) を含む。
ppXchgCert : [var] メッセージを復号するために必要な秘密鍵交換鍵に対応する証明書を表す CERT_CONTEXT 構造体へのポインタ。関数が復号に使用された証明書コンテキストを返さないことを示すには、このパラメータを NULL に設定する。

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

解説

CryptDecryptMessage 関数はメッセージを復号化および復号する。

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

[備考]
pbDecrypted に NULL が渡され、pcbDecrypted が NULL でない場合、ppXchgCert
に渡されたアドレスには NULL が返される。それ以外の場合は CERT_CONTEXT
へのポインタが返される。復号に成功したメッセージについて、この CERT_CONTEXT
へのポインタはメッセージの復号に使用された証明書コンテキストを指す。これは CertFreeCertificateContext
を呼び出して解放しなければならない。関数が失敗した場合、ppXchgCert の値は NULL に設定される。

情報