Pkcs12KeyBag(ReadOnlyMemory<Byte>, Boolean) Konstruktor

Definition

Namespace:

System.Security.Cryptography.Pkcs

Assembly:

System.Security.Cryptography.Pkcs.dll

Paket:

System.Security.Cryptography.Pkcs v9.0.0-preview.4.24266.19

Quelle:

Pkcs12KeyBag.cs

Initialisiert eine neue Instanz des Pkcs12KeyBag aus einem vorhandenen codierten PKCS#8 PrivateKeyInfo-Wert.

public Pkcs12KeyBag (ReadOnlyMemory<byte> pkcs8PrivateKey, bool skipCopy = false);

new System.Security.Cryptography.Pkcs.Pkcs12KeyBag : ReadOnlyMemory<byte> * bool -> System.Security.Cryptography.Pkcs.Pkcs12KeyBag

Public Sub New (pkcs8PrivateKey As ReadOnlyMemory(Of Byte), Optional skipCopy As Boolean = false)

Parameter

pkcs8PrivateKey

ReadOnlyMemory<Byte>

Ein BER-codierter PKCS#8 PrivateKeyInfo-Wert.

skipCopy

Boolean

true zum Speichern von pkcs8PrivateKey, ohne eine defensive Kopie zu erstellen, andernfalls false. Der Standardwert ist false.

Ausnahmen

CryptographicException

Der pkcs8privateKey-Parameter stellt keinen einzelnen ASN.1 BER-codierten Wert dar.

Hinweise

Diese Methode überprüft, dass pkcs8PrivateKey es sich um einen einzelnen BER-codierten Wert handelt, aber es wird nicht überprüft, ob es sich bei dem Wert um einen ordnungsgemäßen PKCS#8 PrivateKeyInfo-Wert handelt.

Das Transportieren privater Schlüssel in einem KeyBag ist nach dem PKCS#12-Standard zulässig, aber nicht alle PFX-Leser unterstützen das Koppeln von Zertifikaten mit Schlüsseln aus einem KeyBag. Um die beste Unterstützung zu erhalten, transportieren Sie Schlüssel in einem ShroudedKeyBag (Pkcs12ShroudedKeyBag).

Das Standardverhalten dieser Methode besteht darin, eine defensive Kopie von pkcs8PrivateKeyzu erstellen. Wenn der skipCopy Parameter ist true, wird diese defensive Kopie übersprungen. Wenn die defensive Kopie übersprungen wird und sich der Inhalt der pkcs8PrivateKey Änderung während der Lebensdauer des zurückgegebenen Werts oder eines beliebigen Objekts ändert, das von seinen Methoden oder Eigenschaften erzeugt wird, können Methoden und Eigenschaften für diese Objekte unsinnige Ergebnisse erzeugen oder aufgrund des beschädigten Zustands Ausnahmen auslösen. Aufrufern wird daher empfohlen, nur einen true Wert für den skipCopy Parameter zu verwenden, wenn sie einigermaßen sicher sein können, dass die Daten intakt bleiben.

Weitere Informationen

• AddKeyUnencrypted(AsymmetricAlgorithm)