Udostępnij za pośrednictwem

X509CertificateLoader.LoadPkcs12 Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Security.Cryptography.X509Certificates
Zestaw:
Microsoft.Bcl.Cryptography.dll
Zestaw:
System.Security.Cryptography.dll
Pakiet:
Microsoft.Bcl.Cryptography v9.0.0

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
Ź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

X509Certificate2

Załadowany certyfikat.

Wyjątki

ArgumentNullException

data jest null.

ArgumentException

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

PlatformNotSupportedException

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

Pkcs12LoadLimitExceededException

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

CryptographicException

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
Ź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

X509Certificate2

Załadowany certyfikat.

Wyjątki

ArgumentNullException

data jest null.

ArgumentException

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

PlatformNotSupportedException

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

Pkcs12LoadLimitExceededException

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

CryptographicException

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