X509CertificateLoader.LoadPkcs12 Metoda
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.
Przeciążenia
| Nazwa | Opis |
|---|---|
| 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
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
- Ź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.