X509CertificateLoader.LoadPkcs12 Metoda

Definice

Obor názvů:

System.Security.Cryptography.X509Certificates

Sestavení:

System.Security.Cryptography.dll

Přetížení

LoadPkcs12(Byte[], String, X509KeyStorageFlags, Pkcs12LoaderLimits)	Načte zadaná data jako PKCS#12 PFX a extrahuje certifikát.
LoadPkcs12(ReadOnlySpan<Byte>, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits)	Načte zadaná data jako PKCS#12 PFX a extrahuje certifikát.

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

Načte zadaná data jako PKCS#12 PFX a extrahuje certifikát.

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[]

Data, která se mají načíst.

password

String

Heslo k dešifrování obsahu PFX.

keyStorageFlags

X509KeyStorageFlags

Bitové kombinace hodnot výčtu, které řídí, kde a jak importovat privátní klíč přidružený k vráceným certifikátu.

loaderLimits

Pkcs12LoaderLimits

Omezení, která se mají použít při načítání PFX. Výchozí hodnota null odpovídá Defaults.

Návraty

X509Certificate2

Načtený certifikát.

Výjimky

ArgumentNullException

data je null.

ArgumentException

keyStorageFlags obsahuje hodnotu nebo kombinaci hodnot, která není platná.

PlatformNotSupportedException

keyStorageFlags obsahuje hodnotu, která není platná pro aktuální platformu.

Pkcs12LoadLimitExceededException

PkCS#12/PFX porušila jedno nebo více omezení loaderLimits.

CryptographicException

Při načítání PKCS#12/PFX došlo k chybě.

Poznámky

PKCS#12/PFX může obsahovat více certifikátů. Pomocí řazení, které se certifikáty zobrazí ve výsledcích LoadPkcs12Collection(ReadOnlySpan<Byte>, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits), tato metoda vrátí první certifikát, kde HasPrivateKey je true. Pokud žádné certifikáty nemají přidružené privátní klíče, vrátí se první certifikát. Pokud PKCS#12/PFX neobsahuje žádné certifikáty, vyvolá se CryptographicException.

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

Načte zadaná data jako PKCS#12 PFX a extrahuje certifikát.

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>

Data, která se mají načíst.

password

ReadOnlySpan<Char>

Heslo k dešifrování obsahu PFX.

keyStorageFlags

X509KeyStorageFlags

Bitové kombinace hodnot výčtu, které řídí, kde a jak importovat privátní klíč přidružený k vráceným certifikátu.

loaderLimits

Pkcs12LoaderLimits

Omezení, která se mají použít při načítání PFX. Výchozí hodnota null odpovídá Defaults.

Návraty

X509Certificate2

Načtený certifikát.

Výjimky

ArgumentNullException

data je null.

ArgumentException

keyStorageFlags obsahuje hodnotu nebo kombinaci hodnot, která není platná.

PlatformNotSupportedException

keyStorageFlags obsahuje hodnotu, která není platná pro aktuální platformu.

Pkcs12LoadLimitExceededException

PkCS#12/PFX porušila jedno nebo více omezení loaderLimits.

CryptographicException

Při načítání PKCS#12/PFX došlo k chybě.

Poznámky

PKCS#12/PFX může obsahovat více certifikátů. Pomocí řazení, které se certifikáty zobrazí ve výsledcích LoadPkcs12Collection(Byte[], String, X509KeyStorageFlags, Pkcs12LoaderLimits), tato metoda vrátí první certifikát, kde HasPrivateKey je true. Pokud žádné certifikáty nemají přidružené privátní klíče, vrátí se první certifikát. Pokud PKCS#12/PFX neobsahuje žádné certifikáty, vyvolá se CryptographicException.