SymmetricAlgorithm.TryDecryptCbc Method

Definition

Namespace:

System.Security.Cryptography

Assembly:

System.Security.Cryptography.dll

Source:

SymmetricAlgorithm.cs

Attempts to decrypt data into the specified buffer, using CBC mode with the specified padding mode.

public bool TryDecryptCbc (ReadOnlySpan<byte> ciphertext, ReadOnlySpan<byte> iv, Span<byte> destination, out int bytesWritten, System.Security.Cryptography.PaddingMode paddingMode = System.Security.Cryptography.PaddingMode.PKCS7);

member this.TryDecryptCbc : ReadOnlySpan<byte> * ReadOnlySpan<byte> * Span<byte> * int * System.Security.Cryptography.PaddingMode -> bool

Public Function TryDecryptCbc (ciphertext As ReadOnlySpan(Of Byte), iv As ReadOnlySpan(Of Byte), destination As Span(Of Byte), ByRef bytesWritten As Integer, Optional paddingMode As PaddingMode = System.Security.Cryptography.PaddingMode.PKCS7) As Boolean

Parameters

ciphertext

ReadOnlySpan<Byte>

The data to decrypt.

iv

ReadOnlySpan<Byte>

The initialization vector.

destination

Span<Byte>

The buffer to receive the plaintext data.

bytesWritten

Int32

When this method returns, contains the total number of bytes written to destination.

paddingMode

PaddingMode

The padding mode used to produce the ciphertext and remove during decryption.

Returns

Boolean

true if destination was large enough to receive the decrypted data; otherwise, false.

Exceptions

ArgumentOutOfRangeException

paddingMode is not a valid padding mode.

ArgumentException

iv is the incorrect length. Callers are expected to pass an initialization vector that is exactly BlockSize in length, converted to bytes (BlockSize / 8).

CryptographicException

The ciphertext could not be decrypted successfully.

Remarks

This method's behavior is defined by TryDecryptCbcCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32).