X509CertificateLoader.LoadPkcs12 Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Overloads
| Name | Description |
|---|---|
| LoadPkcs12(Byte[], String, X509KeyStorageFlags, Pkcs12LoaderLimits) |
Laadt de opgegeven gegevens als PKCS#12 PFX en extraheert een certificaat. |
| LoadPkcs12(ReadOnlySpan<Byte>, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits) |
Laadt de opgegeven gegevens als PKCS#12 PFX en extraheert een certificaat. |
LoadPkcs12(Byte[], String, X509KeyStorageFlags, Pkcs12LoaderLimits)
Laadt de opgegeven gegevens als PKCS#12 PFX en extraheert een certificaat.
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
Parameters
- data
- Byte[]
De gegevens die moeten worden geladen.
- password
- String
Het wachtwoord voor het ontsleutelen van de inhoud van de PFX.
- keyStorageFlags
- X509KeyStorageFlags
Een bitsgewijze combinatie van de opsommingswaarden waarmee wordt bepaald waar en hoe u de persoonlijke sleutel importeert die is gekoppeld aan het geretourneerde certificaat.
- loaderLimits
- Pkcs12LoaderLimits
Limieten die moeten worden toegepast bij het laden van de PFX. Een null waarde, de standaardwaarde, is gelijk aan Defaults.
Retouren
Het geladen certificaat.
Uitzonderingen
data is null.
keyStorageFlags bevat een waarde, of een combinatie van waarden, die ongeldig is.
keyStorageFlags bevat een waarde die niet geldig is voor het huidige platform.
De PKCS#12/PFX heeft een of meer beperkingen van loaderLimits.
Er is een fout opgetreden tijdens het laden van de PKCS#12/PFX.
Opmerkingen
Een PKCS#12/PFX kan meerdere certificaten bevatten. Met behulp van de volgorde waarin de certificaten worden weergegeven in de resultaten van LoadPkcs12Collection(ReadOnlySpan<Byte>, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits), retourneert deze methode het eerste certificaat waar HasPrivateKey zich bevindt true. Als er geen certificaten aan persoonlijke sleutels zijn gekoppeld, wordt het eerste certificaat geretourneerd. Als de PKCS#12/PFX geen certificaten bevat, wordt er een CryptographicException gegenereerd.
Van toepassing op
LoadPkcs12(ReadOnlySpan<Byte>, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits)
Laadt de opgegeven gegevens als PKCS#12 PFX en extraheert een certificaat.
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
Parameters
- data
- ReadOnlySpan<Byte>
De gegevens die moeten worden geladen.
- password
- ReadOnlySpan<Char>
Het wachtwoord voor het ontsleutelen van de inhoud van de PFX.
- keyStorageFlags
- X509KeyStorageFlags
Een bitsgewijze combinatie van de opsommingswaarden waarmee wordt bepaald waar en hoe u de persoonlijke sleutel importeert die is gekoppeld aan het geretourneerde certificaat.
- loaderLimits
- Pkcs12LoaderLimits
Limieten die moeten worden toegepast bij het laden van de PFX. Een null waarde, de standaardwaarde, is gelijk aan Defaults.
Retouren
Het geladen certificaat.
Uitzonderingen
data is null.
keyStorageFlags bevat een waarde, of een combinatie van waarden, die ongeldig is.
keyStorageFlags bevat een waarde die niet geldig is voor het huidige platform.
De PKCS#12/PFX heeft een of meer beperkingen van loaderLimits.
Er is een fout opgetreden tijdens het laden van de PKCS#12/PFX.
Opmerkingen
Een PKCS#12/PFX kan meerdere certificaten bevatten. Met behulp van de volgorde waarin de certificaten worden weergegeven in de resultaten van LoadPkcs12Collection(Byte[], String, X509KeyStorageFlags, Pkcs12LoaderLimits), retourneert deze methode het eerste certificaat waar HasPrivateKey zich bevindt true. Als er geen certificaten aan persoonlijke sleutels zijn gekoppeld, wordt het eerste certificaat geretourneerd. Als de PKCS#12/PFX geen certificaten bevat, wordt er een CryptographicException gegenereerd.