Pkcs12KeyBag(ReadOnlyMemory<Byte>, Boolean) Konstruktor
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Inicjuje nowe wystąpienie Pkcs12KeyBag klasy z istniejącej zakodowanej wartości PKCS#8 PrivateKeyInfo.
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)
Parametry
- pkcs8PrivateKey
- ReadOnlyMemory<Byte>
Wartość PKCS#8 PrivateKeyInfo zakodowana w formacie BER.
- skipCopy
- Boolean
true
do przechowywania pkcs8PrivateKey
bez tworzenia kopii defensywnej; w przeciwnym razie . false
Wartość domyślna to false
.
Wyjątki
Parametr pkcs8privateKey
nie reprezentuje pojedynczej wartości zakodowanej w formacie BER ASN.1.
Uwagi
Ta metoda sprawdza, czy pkcs8PrivateKey
jest to pojedyncza wartość zakodowana w formacie BER, ale nie sprawdza, czy wartość jest właściwą wartością PKCS#8 PrivateKeyInfo.
Transport kluczy prywatnych w usłudze KeyBag jest dozwolony przez standard PKCS#12, ale nie wszystkie czytniki PFX obsługują parowanie certyfikatów z kluczami z usługi KeyBag. Aby uzyskać najlepszą obsługę, klucze transportu w ShroudedKeyBag (Pkcs12ShroudedKeyBag).
Domyślnym zachowaniem tej metody jest utworzenie defensywnej kopii elementu pkcs8PrivateKey
.
skipCopy
Gdy parametr ma true
wartość , ta kopia defensywna jest pomijana.
Jeśli kopia defensywna zostanie pominięta, a zawartość pkcs8PrivateKey
zmiany w okresie istnienia zwracanej wartości lub dowolnego obiektu utworzonego przez jego metody lub właściwości, metody i właściwości tych obiektów mogą generować wyniki bzdur lub zgłaszać wyjątki z powodu uszkodzonego stanu.
W związku z tym zaleca się używanie true
wartości parametru skipCopy
tylko wtedy, gdy mogą być uzasadnione, że dane pozostaną nienaruszone.