ChaCha20Poly1305.Decrypt Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| Decrypt(Byte[], Byte[], Byte[], Byte[], Byte[]) |
Entschlüsselt den Chiffretext in den angegebenen Zielpuffer, wenn das Authentifizierungstag validiert werden kann. |
| Decrypt(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, ReadOnlySpan<Byte>) |
Entschlüsselt den Chiffretext in den angegebenen Zielpuffer, wenn das Authentifizierungstag validiert werden kann. |
Decrypt(Byte[], Byte[], Byte[], Byte[], Byte[])
Entschlüsselt den Chiffretext in den angegebenen Zielpuffer, wenn das Authentifizierungstag validiert werden kann.
public void Decrypt (byte[] nonce, byte[] ciphertext, byte[] tag, byte[] plaintext, byte[]? associatedData = default);member this.Decrypt : byte[] * byte[] * byte[] * byte[] * byte[] -> unitPublic Sub Decrypt (nonce As Byte(), ciphertext As Byte(), tag As Byte(), plaintext As Byte(), Optional associatedData As Byte() = Nothing)Parameter
- nonce
- Byte[]
Die dieser Nachricht zugeordneten Nonce, die mit dem Wert übereinstimmen muss, der während der Verschlüsselung bereitgestellt wird.
- ciphertext
- Byte[]
Der verschlüsselte Inhalt, der entschlüsselt werden soll.
- tag
- Byte[]
Das Authentifizierungstag, das während der Verschlüsselung für diese Nachricht produziert wird.
- plaintext
- Byte[]
Das Bytearray, das den entschlüsselten Inhalt empfangen soll.
- associatedData
- Byte[]
Die dieser Nachricht zugeordneten zusätzlichen Daten, die mit dem Wert übereinstimmen müssen, der während der Verschlüsselung bereitgestellt wird.
Ausnahmen
Die Parameter plaintext und ciphertext weisen nicht die gleiche Länge auf.
- oder -
Die nonce Parameterlänge beträgt nicht 12 Bytes (96 Bit).
Oder
Die tag Parameterlänge beträgt nicht 16 Bytes (128 Bit).
Der Parameter nonce, ciphertext,tag oder plaintext ist null.
Der Tagwert konnte nicht verifiziert werden, oder der Entschlüsselungsvorgang ist anderweitig fehlgeschlagen.
Hinweise
Wenn tag nicht überprüft werden kann (mithilfe des Schlüssels, nonce``ciphertext, des Werts und associatedData der Werte), wird dann plaintext gelöscht.
Gilt für:
Decrypt(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, ReadOnlySpan<Byte>)
Entschlüsselt den Chiffretext in den angegebenen Zielpuffer, wenn das Authentifizierungstag validiert werden kann.
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> -> unitPublic 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)Parameter
- nonce
- ReadOnlySpan<Byte>
Die dieser Nachricht zugeordneten Nonce, die mit dem Wert übereinstimmen muss, der während der Verschlüsselung bereitgestellt wird.
- ciphertext
- ReadOnlySpan<Byte>
Der verschlüsselte Inhalt, der entschlüsselt werden soll.
- tag
- ReadOnlySpan<Byte>
Das Authentifizierungstag, das während der Verschlüsselung für diese Nachricht produziert wird.
- associatedData
- ReadOnlySpan<Byte>
Die dieser Nachricht zugeordneten zusätzlichen Daten, die mit dem Wert übereinstimmen müssen, der während der Verschlüsselung bereitgestellt wird.
Ausnahmen
Die Parameter plaintext und ciphertext weisen nicht die gleiche Länge auf.
- oder -
Die nonce Parameterlänge beträgt nicht 12 Bytes (96 Bit).
Oder
Die tag Parameterlänge beträgt nicht 16 Bytes (128 Bit).
Der Tagwert konnte nicht verifiziert werden, oder der Entschlüsselungsvorgang ist anderweitig fehlgeschlagen.
Hinweise
Wenn tag nicht überprüft werden kann (mithilfe des Schlüssels, nonce``ciphertext, des Werts und associatedData der Werte), wird dann plaintext gelöscht.