ECDiffieHellman.ImportEncryptedPkcs8PrivateKey Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Overloads
| Name | Description |
|---|---|
| ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Int32) |
Importeert de openbare/persoonlijke keypair uit een PKCS#8 EncryptedPrivateKeyInfo-structuur na ontsleuteling met een op byte gebaseerd wachtwoord, waarbij de sleutels voor dit object worden vervangen. |
| ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Char>, ReadOnlySpan<Byte>, Int32) |
Importeert de openbare/persoonlijke keypair uit een PKCS#8 EncryptedPrivateKeyInfo-structuur na ontsleuteling met een wachtwoord op basis van tekens, waarbij de sleutels voor dit object worden vervangen. |
ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Int32)
Importeert de openbare/persoonlijke keypair uit een PKCS#8 EncryptedPrivateKeyInfo-structuur na ontsleuteling met een op byte gebaseerd wachtwoord, waarbij de sleutels voor dit object worden vervangen.
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 -> unitPublic Overrides Sub ImportEncryptedPkcs8PrivateKey (passwordBytes As ReadOnlySpan(Of Byte), source As ReadOnlySpan(Of Byte), ByRef bytesRead As Integer)Parameters
- passwordBytes
- ReadOnlySpan<Byte>
De bytes die moeten worden gebruikt als wachtwoord bij het ontsleutelen van het sleutelmateriaal.
- source
- ReadOnlySpan<Byte>
De bytes van een PKCS#8 EncryptedPrivateKeyInfo-structuur in de ASN.1-BER-codering.
- bytesRead
- Int32
Wanneer deze methode wordt geretourneerd, bevat deze een waarde die het aantal bytes aangeeft waaruit wordt gelezen source. Deze parameter wordt behandeld als niet-geïnitialiseerd.
Uitzonderingen
Het wachtwoord is onjuist.
– of –
De inhoud van source deze functie geeft aan dat de KDF (Key Derivation Function) moet worden toegepast, is de verouderde PKCS#12 KDF, waarvoor op -gebaseerde wachtwoorden zijn vereist Char.
– of –
De inhoud van source deze indeling vertegenwoordigt geen ASN.1-BER gecodeerde PKCS#8 EncryptedPrivateKeyInfo-structuur.
– of –
De inhoud van source geeft aan dat de sleutel voor een ander algoritme is dan het algoritme dat wordt vertegenwoordigd door dit exemplaar.
– of –
De inhoud van source de sleutel in een indeling die niet wordt ondersteund.
– of –
Het importeren van de algoritmespecifieke sleutel is mislukt.
Opmerkingen
De wachtwoordbytes worden rechtstreeks doorgegeven aan de sleutel derivation-functie (KDF) die wordt gebruikt door het algoritme dat wordt aangegeven door de inhoud van EncryptedPrivateKeyInfo. Dit maakt compatibiliteit mogelijk met andere systemen die gebruikmaken van een andere tekstcodering dan UTF-8 bij het verwerken van wachtwoorden met PBKDF2 (Password-Based Key Derivation Function 2). Deze methode ondersteunt alleen de binaire codering (BER/CER/DER) van EncryptedPrivateKeyInfo. Als de waarde Base64-gecodeerd of in de PEM-tekstindeling is, moet de aanroeper de inhoud van Base64 decoderen voordat deze methode wordt aangeroepen.
Van toepassing op
ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Char>, ReadOnlySpan<Byte>, Int32)
Importeert de openbare/persoonlijke keypair uit een PKCS#8 EncryptedPrivateKeyInfo-structuur na ontsleuteling met een wachtwoord op basis van tekens, waarbij de sleutels voor dit object worden vervangen.
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 -> unitPublic Overrides Sub ImportEncryptedPkcs8PrivateKey (password As ReadOnlySpan(Of Char), source As ReadOnlySpan(Of Byte), ByRef bytesRead As Integer)Parameters
- password
- ReadOnlySpan<Char>
Het wachtwoord dat moet worden gebruikt voor het ontsleutelen van het sleutelmateriaal.
- source
- ReadOnlySpan<Byte>
De bytes van een PKCS#8 EncryptedPrivateKeyInfo-structuur in de ASN.1-BER-codering.
- bytesRead
- Int32
Wanneer deze methode wordt geretourneerd, bevat deze een waarde die het aantal bytes aangeeft waaruit wordt gelezen source. Deze parameter wordt behandeld als niet-geïnitialiseerd.
Uitzonderingen
Het wachtwoord is onjuist.
– of –
De inhoud van source deze indeling vertegenwoordigt geen ASN.1-BER gecodeerde PKCS#8 EncryptedPrivateKeyInfo-structuur.
– of –
De inhoud van source geeft aan dat de sleutel voor een ander algoritme is dan het algoritme dat wordt vertegenwoordigd door dit exemplaar.
– of –
De inhoud van source de sleutel in een indeling die niet wordt ondersteund.
– of –
Het importeren van de algoritmespecifieke sleutel is mislukt.
Opmerkingen
Wanneer de inhoud van een algoritme aangeeft dat gebruikmaakt van source PBKDF1 (Password-Based Key Derivation Function 1) of PBKDF2 (Password-Based Key Derivation Function 2), wordt het wachtwoord geconverteerd naar bytes via de UTF-8-codering.
Deze methode ondersteunt alleen de binaire codering (BER/CER/DER) van EncryptedPrivateKeyInfo.
Als de waarde Base64-gecodeerd of in de PEM-tekstindeling is, moet de aanroeper de inhoud van Base64 decoderen voordat deze methode wordt aangeroepen.
