MLKem.Decapsulate 方法

定義

命名空間:

System.Security.Cryptography

組件:

System.Security.Cryptography.dll

從提供的密文中解密共享的秘密。

多載

名稱	Description
Decapsulate(Byte[])	從提供的密文中解密共享的秘密。
Decapsulate(ReadOnlySpan<Byte>, Span<Byte>)	從提供的密文中解密共享的秘密。

Decapsulate(Byte[])

來源:

MLKem.cs

從提供的密文中解密共享的秘密。

public:
 cli::array <System::Byte> ^ Decapsulate(cli::array <System::Byte> ^ ciphertext);

public byte[] Decapsulate(byte[] ciphertext);

member this.Decapsulate : byte[] -> byte[]

Public Function Decapsulate (ciphertext As Byte()) As Byte()

參數

ciphertext

Byte[]

密文。

傳回

Byte[]

共享的秘密。

例外狀況

CryptographicException

在解封過程中發生錯誤。

ArgumentException

ciphertext 尺寸不正確。

ArgumentNullException

ciphertext 是 null。

ObjectDisposedException

對象已經處置。

備註

解封只能解封用解封金鑰對應的封裝金鑰所建立的共享秘密。 若使用不同金鑰，ML-KEM 會執行隱含拒絕。

隱性拒絕表示錯誤不會被回傳。 相反地，共享的秘密結果將是確定性但錯誤的。

偵測錯誤金鑰使用是 ML-KEM 演算法使用者關注的問題。

欲了解更多資訊，請參閱FIPS 203，第6.3節。

Decapsulate(ReadOnlySpan<Byte>, Span<Byte>)

來源:

MLKem.cs

從提供的密文中解密共享的秘密。

public:
 void Decapsulate(ReadOnlySpan<System::Byte> ciphertext, Span<System::Byte> sharedSecret);

public void Decapsulate(ReadOnlySpan<byte> ciphertext, Span<byte> sharedSecret);

member this.Decapsulate : ReadOnlySpan<byte> * Span<byte> -> unit

Public Sub Decapsulate (ciphertext As ReadOnlySpan(Of Byte), sharedSecret As Span(Of Byte))

參數

ciphertext

ReadOnlySpan<Byte>

密文。

sharedSecret

Span<Byte>

接收共享秘密的緩衝區。

例外狀況

CryptographicException

在解封過程中發生錯誤。

ArgumentException

ciphertext 尺寸不正確。

-或-

sharedSecret 尺寸不正確。

ObjectDisposedException

對象已經處置。

備註

解封只能解封用解封金鑰對應的封裝金鑰所建立的共享秘密。 若使用不同金鑰，ML-KEM 會執行隱含拒絕。

隱性拒絕表示錯誤不會被回傳。 相反地，共享的秘密結果將是確定性但錯誤的。

偵測錯誤金鑰使用是 ML-KEM 演算法使用者關注的問題。

欲了解更多資訊，請參閱FIPS 203，第6.3節。