Pkcs12KeyBag(ReadOnlyMemory<Byte>, Boolean) Constructeur
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Initialise une nouvelle instance de Pkcs12KeyBag à partir d’une valeur PrivateKeyInfo PKCS#8 codée existante.
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)
Paramètres
- pkcs8PrivateKey
- ReadOnlyMemory<Byte>
Valeur PrivateKeyInfo PKCS#8 codée BER.
- skipCopy
- Boolean
true
pour stocker pkcs8PrivateKey
sans effectuer de copie défensive ; sinon, false
. La valeur par défaut est false
.
Exceptions
Le paramètre pkcs8privateKey
ne représente pas une seule valeur encodée en ASN.1 BER.
Remarques
Cette méthode valide qu’il pkcs8PrivateKey
s’agit d’une seule valeur encodée par BER, mais elle ne vérifie pas que la valeur est une valeur PKCS#8 PrivateKeyInfo appropriée.
Le transport de clés privées dans un KeyBag est autorisé par la norme PKCS#12, mais tous les lecteurs PFX ne prennent pas en charge l’association de certificats avec des clés à partir d’un KeyBag. Pour une prise en charge optimale, transportez les clés dans un ShroudedKeyBag (Pkcs12ShroudedKeyBag).
Le comportement par défaut de cette méthode consiste à effectuer une copie défensive de pkcs8PrivateKey
.
Lorsque le skipCopy
paramètre est true
, cette copie défensive est ignorée.
Si la copie défensive est ignorée et que le contenu de pkcs8PrivateKey
la modification pendant la durée de vie de la valeur retournée ou de tout objet produit par ses méthodes ou propriétés, les méthodes et les propriétés de ces objets peuvent produire des résultats absurdes ou lever des exceptions en raison de l’état endommagé.
Il est donc conseillé aux appelants d’utiliser une true
valeur pour le skipCopy
paramètre uniquement lorsqu’ils peuvent être raisonnablement assurés que les données resteront intactes.