ECDiffieHellman.ImportEncryptedPkcs8PrivateKey Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Přetížení
ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Int32) |
Importuje veřejný/privátní klíčpair ze struktury PKCS#8 EncryptedPrivateKeyInfo po dešifrování heslem založeným na bajtech a nahradí klíče pro tento objekt. |
ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Char>, ReadOnlySpan<Byte>, Int32) |
Importuje veřejný/privátní klíč z struktury PKCS#8 EncryptedPrivateKeyInfo po dešifrování heslem založeným na znaku a nahradí klíče pro tento objekt. |
ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Int32)
Importuje veřejný/privátní klíčpair ze struktury PKCS#8 EncryptedPrivateKeyInfo po dešifrování heslem založeným na bajtech a nahradí klíče pro tento objekt.
public:
override void ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<System::Byte> passwordBytes, ReadOnlySpan<System::Byte> source, [Runtime::InteropServices::Out] int % bytesRead);
public override void ImportEncryptedPkcs8PrivateKey (ReadOnlySpan<byte> passwordBytes, ReadOnlySpan<byte> source, out int bytesRead);
override this.ImportEncryptedPkcs8PrivateKey : ReadOnlySpan<byte> * ReadOnlySpan<byte> * int -> unit
Public Overrides Sub ImportEncryptedPkcs8PrivateKey (passwordBytes As ReadOnlySpan(Of Byte), source As ReadOnlySpan(Of Byte), ByRef bytesRead As Integer)
Parametry
- passwordBytes
- ReadOnlySpan<Byte>
Bajty, které se mají použít jako heslo při dešifrování materiálu klíče.
- source
- ReadOnlySpan<Byte>
Bajty struktury PKCS#8 EncryptedPrivateKeyInfo v kódování ASN.1-BER.
- bytesRead
- Int32
Když tato metoda vrátí, obsahuje hodnotu, která označuje počet bajtů načtených z source
. Tento parametr se považuje za neinicializovaný.
Výjimky
Heslo je nesprávné.
-nebo-
Obsah source
označující, že funkce odvození klíče (KDF) k použití je starší verze pkCS#12 KDF, která vyžaduje Charhesla založená na klíči.
-nebo-
Obsah source
nepředstavuje strukturu PKCS#8 EncryptedPrivateKeyInfo s kódováním ASN.1-BER.
-nebo-
Obsah indikace source
klíče je pro jiný algoritmus, než je algoritmus reprezentovaný touto instancí.
-nebo-
Obsah source
představuje klíč ve formátu, který není podporován.
-nebo-
Import klíče specifický pro algoritmus se nezdařil.
Poznámky
Bajty hesel se předávají přímo do funkce KDF (Key Derivation Function) používané algoritmem označeným obsahem EncryptedPrivateKeyInfo. To umožňuje kompatibilitu s jinými systémy, které používají jiné kódování textu než UTF-8 při zpracování hesel pomocí PBKDF2 (funkce odvození klíče založeného na heslech 2). Tato metoda podporuje pouze binární kódování (BER/CER/DER) encryptedPrivateKeyInfo. Pokud je hodnota base64 kódována nebo ve formátu textu PEM, volající musí před voláním této metody dekódovat obsah Base64.
Platí pro
ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Char>, ReadOnlySpan<Byte>, Int32)
Importuje veřejný/privátní klíč z struktury PKCS#8 EncryptedPrivateKeyInfo po dešifrování heslem založeným na znaku a nahradí klíče pro tento objekt.
public:
override void ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<char> password, ReadOnlySpan<System::Byte> source, [Runtime::InteropServices::Out] int % bytesRead);
public override void ImportEncryptedPkcs8PrivateKey (ReadOnlySpan<char> password, ReadOnlySpan<byte> source, out int bytesRead);
override this.ImportEncryptedPkcs8PrivateKey : ReadOnlySpan<char> * ReadOnlySpan<byte> * int -> unit
Public Overrides Sub ImportEncryptedPkcs8PrivateKey (password As ReadOnlySpan(Of Char), source As ReadOnlySpan(Of Byte), ByRef bytesRead As Integer)
Parametry
- password
- ReadOnlySpan<Char>
Heslo, které se má použít k dešifrování materiálu klíče.
- source
- ReadOnlySpan<Byte>
Bajty struktury PKCS#8 EncryptedPrivateKeyInfo v kódování ASN.1-BER.
- bytesRead
- Int32
Když tato metoda vrátí, obsahuje hodnotu, která označuje počet bajtů načtených z source
. Tento parametr se považuje za neinicializovaný.
Výjimky
Heslo je nesprávné.
-nebo-
Obsah source
nepředstavuje strukturu PKCS#8 EncryptedPrivateKeyInfo s kódováním ASN.1-BER.
-nebo-
Obsah indikace source
klíče je pro jiný algoritmus, než je algoritmus reprezentovaný touto instancí.
-nebo-
Obsah source
představuje klíč ve formátu, který není podporován.
-nebo-
Import klíče specifický pro algoritmus se nezdařil.
Poznámky
Pokud obsah source
indikuje algoritmus, který používá PBKDF1 (funkce odvození klíče založené na heslech 1) nebo PBKDF2 (funkce odvození klíče založené na heslech 2), heslo se převede na bajty prostřednictvím kódování UTF-8.
Tato metoda podporuje pouze binární kódování (BER/CER/DER) encryptedPrivateKeyInfo.
Pokud je hodnota base64 kódována nebo ve formátu textu PEM, volající musí před voláním této metody dekódovat obsah Base64.