AsymmetricAlgorithm.ImportEncryptedPkcs8PrivateKey Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
| Nombre | Description |
|---|---|
| ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Int32) |
Cuando se reemplaza en una clase derivada, importa el keypair público/privado de una estructura EncryptedPrivateKeyInfo de PKCS#8 después de descifrar con una contraseña basada en bytes, reemplazando las claves de este objeto. |
| ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Char>, ReadOnlySpan<Byte>, Int32) |
Cuando se reemplaza en una clase derivada, importa el keypair público/privado de una estructura EncryptedPrivateKeyInfo de PKCS#8 después de descifrar con una contraseña basada en caracteres, reemplazando las claves de este objeto. |
ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Int32)
Cuando se reemplaza en una clase derivada, importa el keypair público/privado de una estructura EncryptedPrivateKeyInfo de PKCS#8 después de descifrar con una contraseña basada en bytes, reemplazando las claves de este objeto.
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)Parámetros
- passwordBytes
- ReadOnlySpan<Byte>
Bytes que se usarán como contraseña al descifrar el material de clave.
- source
- ReadOnlySpan<Byte>
Bytes de una estructura EncryptedPrivateKeyInfo de PKCS#8 en la codificación ASN.1-BER.
- bytesRead
- Int32
Cuando este método devuelve , contiene un valor que indica el número de bytes leídos de source. Este parámetro se trata como sin inicializar.
Excepciones
La contraseña no es correcta.
O bien
El contenido de source indica que la función de derivación de claves (KDF) que se va a aplicar es el KDF PKCS#12 heredado, que requiere Charcontraseñas basadas en .
O bien
El contenido de source no representa una estructura PKCS#8 EncryptedPrivateKeyInfo codificada en ASN.1-BER.
O bien
El contenido de source indica que la clave es para un algoritmo distinto del algoritmo representado por esta instancia.
O bien
El contenido de source representa la clave en un formato que no se admite.
O bien
Error en la importación de clave específica del algoritmo.
Un tipo derivado no ha invalidado este miembro.
Comentarios
Los bytes de contraseña se pasan directamente a la función de derivación de claves (KDF) usada por el algoritmo indicado por pbeParameters.
Esto permite la compatibilidad con otros sistemas que usan una codificación de texto distinta de UTF-8 al procesar contraseñas con PBKDF2 (Password-Based función de derivación de claves 2).
Este método solo admite la codificación binaria (BER/CER/DER) de EncryptedPrivateKeyInfo. Si el valor está codificado en Base64 o en el formato de texto PEM, el autor de la llamada debe descodificar el contenido antes de llamar a este método.
Dado que se requiere compatibilidad específica del algoritmo para interpretar el contenido de este formato de datos, ImportEncryptedPkcs8PrivateKey produce una NotImplementedException excepción de forma predeterminada.
Se aplica a
ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Char>, ReadOnlySpan<Byte>, Int32)
Cuando se reemplaza en una clase derivada, importa el keypair público/privado de una estructura EncryptedPrivateKeyInfo de PKCS#8 después de descifrar con una contraseña basada en caracteres, reemplazando las claves de este objeto.
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)Parámetros
- password
- ReadOnlySpan<Char>
Contraseña que se va a usar para descifrar el material de clave.
- source
- ReadOnlySpan<Byte>
Bytes de una estructura EncryptedPrivateKeyInfo de PKCS#8 en la codificación ASN.1-BER.
- bytesRead
- Int32
Cuando este método devuelve , contiene un valor que indica el número de bytes leídos de source. Este parámetro se trata como sin inicializar.
Excepciones
La contraseña no es correcta.
O bien
El contenido de source no representa una estructura PKCS#8 EncryptedPrivateKeyInfo codificada en ASN.1-BER.
O bien
El contenido de source indica que la clave es para un algoritmo distinto del algoritmo representado por esta instancia.
O bien
El contenido de source representa la clave en un formato que no se admite.
O bien
Error en la importación de clave específica del algoritmo.
Un tipo derivado no ha invalidado este miembro.
Comentarios
Cuando el contenido de source indica un algoritmo que usa PBKDF1 (Password-Based función de derivación de claves 1) o PBKDF2 (Password-Based función de derivación de claves 2), la contraseña se convierte en bytes a través de la codificación UTF-8.
Este método solo admite la codificación binaria (BER/CER/DER) de EncryptedPrivateKeyInfo. Si el valor está codificado en Base64 o en el formato de texto PEM, el autor de la llamada debe descodificar el contenido antes de llamar a este método.
Dado que se requiere compatibilidad específica del algoritmo para interpretar el contenido de este formato de datos, ImportEncryptedPkcs8PrivateKey produce una NotImplementedException excepción de forma predeterminada.