X509CertificateLoader.LoadPkcs12 Metoda

Definicja

Przeciążenia

LoadPkcs12(Byte[], String, X509KeyStorageFlags, Pkcs12LoaderLimits)

Ładuje podane dane jako plik PFX PKCS#12 i wyodrębnia certyfikat.

LoadPkcs12(ReadOnlySpan<Byte>, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits)

Ładuje podane dane jako plik PFX PKCS#12 i wyodrębnia certyfikat.

LoadPkcs12(Byte[], String, X509KeyStorageFlags, Pkcs12LoaderLimits)

Źródło:
X509CertificateLoader.cs

Ładuje podane dane jako plik PFX PKCS#12 i wyodrębnia certyfikat.

public static System.Security.Cryptography.X509Certificates.X509Certificate2 LoadPkcs12 (byte[] data, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags = System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.DefaultKeySet, System.Security.Cryptography.X509Certificates.Pkcs12LoaderLimits? loaderLimits = default);
static member LoadPkcs12 : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags * System.Security.Cryptography.X509Certificates.Pkcs12LoaderLimits -> System.Security.Cryptography.X509Certificates.X509Certificate2
Public Shared Function LoadPkcs12 (data As Byte(), password As String, Optional keyStorageFlags As X509KeyStorageFlags = System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.DefaultKeySet, Optional loaderLimits As Pkcs12LoaderLimits = Nothing) As X509Certificate2

Parametry

data
Byte[]

Dane do załadowania.

password
String

Hasło do odszyfrowywania zawartości pliku PFX.

keyStorageFlags
X509KeyStorageFlags

Bitowa kombinacja wartości wyliczenia kontrolujących miejsce i sposób importowania klucza prywatnego skojarzonego z zwróconym certyfikatem.

loaderLimits
Pkcs12LoaderLimits

Limity, które mają być stosowane podczas ładowania pliku PFX. Wartość domyślna null jest równoważna Defaults.

Zwraca

Załadowany certyfikat.

Wyjątki

data jest null.

keyStorageFlags zawiera wartość lub kombinację wartości, które są nieprawidłowe.

keyStorageFlags zawiera wartość nieprawidłową dla bieżącej platformy.

PKCS#12/PFX naruszył co najmniej jedno ograniczenie loaderLimits.

Wystąpił błąd podczas ładowania PKCS#12/PFX.

Uwagi

PKCS#12/PFX może zawierać wiele certyfikatów. Używając kolejności, w której certyfikaty są wyświetlane w wynikach LoadPkcs12Collection(ReadOnlySpan<Byte>, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits), ta metoda zwraca pierwszy certyfikat, w którym HasPrivateKey jest true. Jeśli żadne certyfikaty nie mają skojarzonych kluczy prywatnych, zwracany jest pierwszy certyfikat. Jeśli PKCS#12/PFX nie zawiera żadnych certyfikatów, zostanie zgłoszony CryptographicException.

Dotyczy

LoadPkcs12(ReadOnlySpan<Byte>, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits)

Źródło:
X509CertificateLoader.cs

Ładuje podane dane jako plik PFX PKCS#12 i wyodrębnia certyfikat.

public static System.Security.Cryptography.X509Certificates.X509Certificate2 LoadPkcs12 (ReadOnlySpan<byte> data, ReadOnlySpan<char> password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags = System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.DefaultKeySet, System.Security.Cryptography.X509Certificates.Pkcs12LoaderLimits? loaderLimits = default);
static member LoadPkcs12 : ReadOnlySpan<byte> * ReadOnlySpan<char> * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags * System.Security.Cryptography.X509Certificates.Pkcs12LoaderLimits -> System.Security.Cryptography.X509Certificates.X509Certificate2
Public Shared Function LoadPkcs12 (data As ReadOnlySpan(Of Byte), password As ReadOnlySpan(Of Char), Optional keyStorageFlags As X509KeyStorageFlags = System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.DefaultKeySet, Optional loaderLimits As Pkcs12LoaderLimits = Nothing) As X509Certificate2

Parametry

data
ReadOnlySpan<Byte>

Dane do załadowania.

password
ReadOnlySpan<Char>

Hasło do odszyfrowywania zawartości pliku PFX.

keyStorageFlags
X509KeyStorageFlags

Bitowa kombinacja wartości wyliczenia kontrolujących miejsce i sposób importowania klucza prywatnego skojarzonego z zwróconym certyfikatem.

loaderLimits
Pkcs12LoaderLimits

Limity, które mają być stosowane podczas ładowania pliku PFX. Wartość domyślna null jest równoważna Defaults.

Zwraca

Załadowany certyfikat.

Wyjątki

data jest null.

keyStorageFlags zawiera wartość lub kombinację wartości, które są nieprawidłowe.

keyStorageFlags zawiera wartość nieprawidłową dla bieżącej platformy.

PKCS#12/PFX naruszył co najmniej jedno ograniczenie loaderLimits.

Wystąpił błąd podczas ładowania PKCS#12/PFX.

Uwagi

PKCS#12/PFX może zawierać wiele certyfikatów. Używając kolejności, w której certyfikaty są wyświetlane w wynikach LoadPkcs12Collection(Byte[], String, X509KeyStorageFlags, Pkcs12LoaderLimits), ta metoda zwraca pierwszy certyfikat, w którym HasPrivateKey jest true. Jeśli żadne certyfikaty nie mają skojarzonych kluczy prywatnych, zwracany jest pierwszy certyfikat. Jeśli PKCS#12/PFX nie zawiera żadnych certyfikatów, zostanie zgłoszony CryptographicException.

Dotyczy