AsymmetricAlgorithm.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í
| Name | Description |
|---|---|
| ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Int32) |
Při přepsání v odvozené třídě importuje veřejný/privátní klíčpair z PKCS#8 EncryptedPrivateKeyInfo struktury po dešifrování pomocí bajtového hesla a nahradí klíče pro tento objekt. |
| ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Char>, ReadOnlySpan<Byte>, Int32) |
Při přepsání v odvozené třídě importuje veřejný/privátní klíčpair ze struktury PKCS#8 EncryptedPrivateKeyInfo po dešifrování heslem založeným na znaku a nahradí klíče tohoto objektu. |
ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Int32)
Při přepsání v odvozené třídě importuje veřejný/privátní klíčpair z PKCS#8 EncryptedPrivateKeyInfo struktury po dešifrování pomocí bajtového hesla a nahradí klíče pro tento objekt.
public:
virtual void ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<System::Byte> passwordBytes, ReadOnlySpan<System::Byte> source, [Runtime::InteropServices::Out] int % bytesRead);public virtual void ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<byte> passwordBytes, ReadOnlySpan<byte> source, out int bytesRead);abstract member ImportEncryptedPkcs8PrivateKey : ReadOnlySpan<byte> * ReadOnlySpan<byte> * int -> unit
override this.ImportEncryptedPkcs8PrivateKey : ReadOnlySpan<byte> * ReadOnlySpan<byte> * int -> unitPublic Overridable 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
Pokud tato metoda vrátí, obsahuje hodnotu, která označuje počet bajtů přečtených z source. Tento parametr se považuje za neinicializovaný.
Výjimky
Heslo je nesprávné.
nebo
source Obsah označující, že se má použít funkce odvození klíče (KDF), je starší verze PKCS#12 KDF, která vyžaduje Charhesla založená na klíči.
nebo
source Obsah nepředstavuje strukturu PKCS#8 EncryptedPrivateKeyInfo s kódováním ASN.1-BER.
nebo
Obsah indikace source klíče je určen pro jiný algoritmus než 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.
Odvozený typ nepřepíše tento člen.
Poznámky
Bajty hesel se předávají přímo do funkce KDF (Key Derivation Function) používané algoritmem označeným algoritmem pbeParameters.
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 (Password-Based funkce odvození klíče 2).
Tato metoda podporuje pouze binární kódování (BER/CER/DER) EncryptedPrivateKeyInfo. Pokud je hodnota Base64 kódována nebo v textovém formátu PEM, volající musí před voláním této metody dekódovat obsah Base64.
Vzhledem k tomu, že podpora specifická pro algoritmus je nutná k interpretaci obsahu tohoto formátu dat, ImportEncryptedPkcs8PrivateKey vyvolá NotImplementedException ve výchozím nastavení výjimku.
Platí pro
ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Char>, ReadOnlySpan<Byte>, Int32)
Při přepsání v odvozené třídě importuje veřejný/privátní klíčpair ze struktury PKCS#8 EncryptedPrivateKeyInfo po dešifrování heslem založeným na znaku a nahradí klíče tohoto objektu.
public:
virtual void ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<char> password, ReadOnlySpan<System::Byte> source, [Runtime::InteropServices::Out] int % bytesRead);public virtual void ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<char> password, ReadOnlySpan<byte> source, out int bytesRead);abstract member ImportEncryptedPkcs8PrivateKey : ReadOnlySpan<char> * ReadOnlySpan<byte> * int -> unit
override this.ImportEncryptedPkcs8PrivateKey : ReadOnlySpan<char> * ReadOnlySpan<byte> * int -> unitPublic Overridable 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
Pokud tato metoda vrátí, obsahuje hodnotu, která označuje počet bajtů přečtených z source. Tento parametr se považuje za neinicializovaný.
Výjimky
Heslo je nesprávné.
nebo
source Obsah nepředstavuje strukturu PKCS#8 EncryptedPrivateKeyInfo s kódováním ASN.1-BER.
nebo
Obsah indikace source klíče je určen pro jiný algoritmus než 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.
Odvozený typ nepřepíše tento člen.
Poznámky
Pokud obsah indikuje source algoritmus, který používá PBKDF1 (Password-Based funkce odvození klíče 1) nebo PBKDF2 (Password-Based Funkce odvození klíče 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 v textovém formátu PEM, volající musí před voláním této metody dekódovat obsah Base64.
Vzhledem k tomu, že podpora specifická pro algoritmus je nutná k interpretaci obsahu tohoto formátu dat, ImportEncryptedPkcs8PrivateKey vyvolá NotImplementedException ve výchozím nastavení výjimku.