CryptDecrypt 関数 (wincrypt.h)
Secure/Multipurpose Internet Mail Extensions (S/MIME) 電子メールの相互運用性
構文
BOOL CryptDecrypt(
[in] HCRYPTKEY hKey,
[in] HCRYPTHASH hHash,
[in] BOOL Final,
[in] DWORD dwFlags,
[in, out] BYTE *pbData,
[in, out] DWORD *pdwDataLen
);
パラメーター
[in] hKey
暗号化解除に使用するキーのハンドル。 アプリケーションは、
このキーは、使用する復号化アルゴリズムを指定します。
[in] hHash
ハッシュ オブジェクトへのハンドル。 データの暗号化を解除し、同時にハッシュする場合は、ハッシュ オブジェクトへのハンドルがこのパラメーターで渡されます。 ハッシュ値は、復号化された プレーンテキストで更新されます。 このオプションは、署名の暗号化解除と検証を同時に行う場合に便利です。
CryptDecrypt
ハッシュを実行しない場合、このパラメーターは 0 である必要があります。
[in] Final
これが復号化される系列の最後のセクションであるかどうかを示すブール値。 この値は、最後のブロックまたは唯一のブロックの場合は TRUE
[in] dwFlags
次のフラグ値が定義されています。
| 価値 | 意味 |
|---|---|
|
最適な非対称暗号化パディング (OAEP) (PKCS #1 バージョン 2) を使用します。 このフラグは、RSA 暗号化/暗号化解除を使用する microsoft Enhanced Cryptographic Provider |
|
パディングを確認せずに、BLOB で復号化を実行します。 このフラグは、RSA 暗号化/暗号化解除を使用する microsoft Enhanced Cryptographic Provider |
[in, out] pbData
復号化するデータを格納しているバッファーへのポインター。 復号化が実行されると、プレーンテキストはこの同じバッファーに戻されます。
このバッファー内の暗号化されたバイト数は、pdwDataLenによって指定
[in, out] pdwDataLen
pbData バッファーの長さを示す DWORD 値へのポインター。 この関数を呼び出す前に、呼び出し元のアプリケーションは、DWORD 値を復号化するバイト数に設定します。 返されると、DWORD 値には、復号化されたプレーンテキストのバイト数が含まれます。
戻り値
関数が成功した場合、関数は 0 以外 (TRUE) を返します。
関数が失敗した場合は、0 (FALSE
NTE で開始されるエラー コードは、使用されている特定の CSP によって生成されます。 考えられるエラー コードの一部を次に示します。
| 価値 | 形容 |
|---|---|
|
パラメーターの 1 つは無効なハンドルを指定します。 |
|
パラメーターの 1 つに無効な値が含まれています。 これは、多くの場合、無効なポインターです。 |
|
hKeyセッション キー は、この CSP がサポートしていないアルゴリズムを指定します。 |
|
復号化するデータが無効です。 たとえば、ブロック暗号が使用され、 |
|
dwFlags パラメーターは 0 以外です。 |
|
hHash パラメーターには、無効なハンドルが含まれています。 |
|
hKey パラメーターに、キーへの有効なハンドルが含まれていません。 |
|
出力バッファーのサイズが小さすぎて、生成されたプレーンテキストを保持できません。 |
|
キーの作成時に指定された CSP コンテキストが見つかりません。 |
|
アプリケーションが同じデータを 2 回復号化しようとしました。 |
|
予期しない方法で関数が失敗しました。 |
備考
大量のデータを復号化する場合は、CryptDecrypt を繰り返し呼び出すことによって、セクションで行うことができます。
- キーがブロック暗号キーの場合、データは暗号のブロック サイズの倍数に埋め込まれます。 暗号のブロック サイズを見つけるには、CryptGetKeyParam を使用してキーのKP_BLOCKLEN値を取得します。
- 暗号が チェーン モードので動作している場合、次の CryptDecrypt 操作によって、暗号のフィードバック レジスタがキーのKP_IV値にリセットされます。
- 暗号が ストリーム暗号の場合、次の CryptDecrypt 呼び出しによって、暗号が初期 状態にリセットされます。
// Set the IV for the original key. Do not use the original key for
// encryption or decryption after doing this because the key's
// feedback register will get modified and you cannot change it.
CryptSetKeyParam(hOriginalKey, KP_IV, newIV)
while(block = NextBlock())
{
// Create a duplicate of the original key. This causes the
// original key's IV to be copied into the duplicate key's
// feedback register.
hDuplicateKey = CryptDuplicateKey(hOriginalKey)
// Decrypt the block with the duplicate key.
CryptDecrypt(hDuplicateKey, block)
// Destroy the duplicate key. Its feedback register has been
// modified by the CryptEncrypt function, so it cannot be used
// again. It will be re-duplicated in the next iteration of the
// loop.
CryptDestroyKey(hDuplicateKey)
}
例
この関数を使用する例については、「サンプル C プログラム: ファイルの復号化」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows XP [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows Server 2003 [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | wincrypt.h |
| ライブラリ | Advapi32.lib |
| DLL | Advapi32.dll |