ChaCha20Poly1305.Decrypt Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
Decrypt(Byte[], Byte[], Byte[], Byte[], Byte[]) |
Расшифровывает зашифрованный текст в предоставленный буфер назначения, если тег проверки подлинности можно проверить. |
Decrypt(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, ReadOnlySpan<Byte>) |
Расшифровывает зашифрованный текст в предоставленный буфер назначения, если тег проверки подлинности можно проверить. |
Decrypt(Byte[], Byte[], Byte[], Byte[], Byte[])
- Исходный код:
- ChaCha20Poly1305.cs
- Исходный код:
- ChaCha20Poly1305.cs
- Исходный код:
- ChaCha20Poly1305.cs
Расшифровывает зашифрованный текст в предоставленный буфер назначения, если тег проверки подлинности можно проверить.
public void Decrypt (byte[] nonce, byte[] ciphertext, byte[] tag, byte[] plaintext, byte[]? associatedData = default);
member this.Decrypt : byte[] * byte[] * byte[] * byte[] * byte[] -> unit
Public Sub Decrypt (nonce As Byte(), ciphertext As Byte(), tag As Byte(), plaintext As Byte(), Optional associatedData As Byte() = Nothing)
Параметры
- nonce
- Byte[]
Nonce, связанный с этим сообщением, который должен соответствовать значению, предоставленному во время шифрования.
- ciphertext
- Byte[]
Зашифрованное содержимое для расшифровки.
- tag
- Byte[]
Тег проверки подлинности, созданный для этого сообщения во время шифрования.
- plaintext
- Byte[]
Массив байтов для получения расшифрованного содержимого.
- associatedData
- Byte[]
Дополнительные данные, связанные с этим сообщением, которые должны соответствовать значению, предоставленному во время шифрования.
Исключения
Параметр plaintext
и ciphertext
не имеют той же длины.
-или-
Длина параметра nonce
не составляет 12 байт (96 бит).
-или-
Длина параметра tag
не составляет 16 байт (128 бит).
Параметр nonce
, ciphertext
, tag
или plaintext
null
.
Не удалось выполнить операцию расшифровки. До .NET 8 указывает, что значение тега не удалось проверить.
.NET 8 и более поздних версий: не удалось проверить значение тега.
Комментарии
Если tag
не удается проверить (с помощью ключа, nonce
, ciphertext
и associatedData
значений), plaintext
очищается.
Применяется к
Decrypt(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, ReadOnlySpan<Byte>)
- Исходный код:
- ChaCha20Poly1305.cs
- Исходный код:
- ChaCha20Poly1305.cs
- Исходный код:
- ChaCha20Poly1305.cs
Расшифровывает зашифрованный текст в предоставленный буфер назначения, если тег проверки подлинности можно проверить.
public void Decrypt (ReadOnlySpan<byte> nonce, ReadOnlySpan<byte> ciphertext, ReadOnlySpan<byte> tag, Span<byte> plaintext, ReadOnlySpan<byte> associatedData = default);
member this.Decrypt : ReadOnlySpan<byte> * ReadOnlySpan<byte> * ReadOnlySpan<byte> * Span<byte> * ReadOnlySpan<byte> -> unit
Public Sub Decrypt (nonce As ReadOnlySpan(Of Byte), ciphertext As ReadOnlySpan(Of Byte), tag As ReadOnlySpan(Of Byte), plaintext As Span(Of Byte), Optional associatedData As ReadOnlySpan(Of Byte) = Nothing)
Параметры
- nonce
- ReadOnlySpan<Byte>
Nonce, связанный с этим сообщением, который должен соответствовать значению, предоставленному во время шифрования.
- ciphertext
- ReadOnlySpan<Byte>
Зашифрованное содержимое для расшифровки.
- tag
- ReadOnlySpan<Byte>
Тег проверки подлинности, созданный для этого сообщения во время шифрования.
- associatedData
- ReadOnlySpan<Byte>
Дополнительные данные, связанные с этим сообщением, которые должны соответствовать значению, предоставленному во время шифрования.
Исключения
Параметр plaintext
и ciphertext
не имеют той же длины.
-или-
Длина параметра nonce
не составляет 12 байт (96 бит).
-или-
Длина параметра tag
не составляет 16 байт (128 бит).
Не удалось выполнить операцию расшифровки. До .NET 8 указывает, что значение тега не удалось проверить.
.NET 8 и более поздних версий: не удалось проверить значение тега.
Комментарии
Если tag
не удается проверить (с помощью ключа, nonce
, ciphertext
и associatedData
значений), plaintext
очищается.