Freigeben über


X509CertificateLoader.LoadPkcs12 Methode

Definition

Überlädt

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

Lädt die bereitgestellten Daten als PKCS#12 PFX und extrahiert ein Zertifikat.

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

Lädt die bereitgestellten Daten als PKCS#12 PFX und extrahiert ein Zertifikat.

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

Quelle:
X509CertificateLoader.cs
Quelle:
X509CertificateLoader.cs

Lädt die bereitgestellten Daten als PKCS#12 PFX und extrahiert ein Zertifikat.

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

Parameter

data
Byte[]

Die zu ladenden Daten.

password
String

Das Kennwort zum Entschlüsseln des Inhalts der PFX.

keyStorageFlags
X509KeyStorageFlags

Eine bitweise Kombination der Enumerationswerte, die steuern, wo und wie der private Schlüssel importiert wird, der dem zurückgegebenen Zertifikat zugeordnet ist.

loaderLimits
Pkcs12LoaderLimits

Grenzwerte, die beim Laden der PFX gelten. Ein null-Wert, der Standardwert, entspricht Defaults.

Gibt zurück

Das geladene Zertifikat.

Ausnahmen

data ist null.

keyStorageFlags einen Ungültigen Wert oder eine Kombination aus Werten enthält.

keyStorageFlags enthält einen Wert, der für die aktuelle Plattform ungültig ist.

Die PKCS#12/PFX verletzte eine oder mehrere Einschränkungen von loaderLimits.

Fehler beim Laden der PKCS#12/PFX.

Hinweise

Ein PKCS#12/PFX kann mehrere Zertifikate enthalten. Mit der Reihenfolge, in der die Zertifikate in den Ergebnissen von LoadPkcs12Collection(ReadOnlySpan<Byte>, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits)angezeigt werden, gibt diese Methode das erste Zertifikat zurück, in dem HasPrivateKeytrueist. Wenn keine Zertifikate private Schlüssel zugeordnet haben, wird das erste Zertifikat zurückgegeben. Wenn die PKCS#12/PFX keine Zertifikate enthält, wird ein CryptographicException ausgelöst.

Gilt für:

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

Quelle:
X509CertificateLoader.cs
Quelle:
X509CertificateLoader.cs

Lädt die bereitgestellten Daten als PKCS#12 PFX und extrahiert ein Zertifikat.

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

Parameter

data
ReadOnlySpan<Byte>

Die zu ladenden Daten.

password
ReadOnlySpan<Char>

Das Kennwort zum Entschlüsseln des Inhalts der PFX.

keyStorageFlags
X509KeyStorageFlags

Eine bitweise Kombination der Enumerationswerte, die steuern, wo und wie der private Schlüssel importiert wird, der dem zurückgegebenen Zertifikat zugeordnet ist.

loaderLimits
Pkcs12LoaderLimits

Grenzwerte, die beim Laden der PFX gelten. Ein null-Wert, der Standardwert, entspricht Defaults.

Gibt zurück

Das geladene Zertifikat.

Ausnahmen

data ist null.

keyStorageFlags einen Ungültigen Wert oder eine Kombination aus Werten enthält.

keyStorageFlags enthält einen Wert, der für die aktuelle Plattform ungültig ist.

Die PKCS#12/PFX verletzte eine oder mehrere Einschränkungen von loaderLimits.

Fehler beim Laden der PKCS#12/PFX.

Hinweise

Ein PKCS#12/PFX kann mehrere Zertifikate enthalten. Mit der Reihenfolge, in der die Zertifikate in den Ergebnissen von LoadPkcs12Collection(Byte[], String, X509KeyStorageFlags, Pkcs12LoaderLimits)angezeigt werden, gibt diese Methode das erste Zertifikat zurück, in dem HasPrivateKeytrueist. Wenn keine Zertifikate private Schlüssel zugeordnet haben, wird das erste Zertifikat zurückgegeben. Wenn die PKCS#12/PFX keine Zertifikate enthält, wird ein CryptographicException ausgelöst.

Gilt für: