X509CertificateLoader.LoadPkcs12FromFile 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 |
|---|---|
| LoadPkcs12FromFile(String, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits) |
Hiermee opent u het opgegeven bestand, leest u de inhoud als PKCS#12 PFX en extraheert u een certificaat. |
| LoadPkcs12FromFile(String, String, X509KeyStorageFlags, Pkcs12LoaderLimits) |
Hiermee opent u het opgegeven bestand, leest u de inhoud als PKCS#12 PFX en extraheert u een certificaat. |
LoadPkcs12FromFile(String, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits)
Hiermee opent u het opgegeven bestand, leest u de inhoud als PKCS#12 PFX en extraheert u een certificaat.
public static System.Security.Cryptography.X509Certificates.X509Certificate2 LoadPkcs12FromFile(string path, ReadOnlySpan<char> password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags = System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.DefaultKeySet, System.Security.Cryptography.X509Certificates.Pkcs12LoaderLimits? loaderLimits = default);
static member LoadPkcs12FromFile : string * ReadOnlySpan<char> * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags * System.Security.Cryptography.X509Certificates.Pkcs12LoaderLimits -> System.Security.Cryptography.X509Certificates.X509Certificate2
Public Shared Function LoadPkcs12FromFile (path As String, password As ReadOnlySpan(Of Char), Optional keyStorageFlags As X509KeyStorageFlags = System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.DefaultKeySet, Optional loaderLimits As Pkcs12LoaderLimits = Nothing) As X509Certificate2
Parameters
- path
- String
Het pad van het bestand dat moet worden geopend.
- 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
path 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.
Er is een fout opgetreden tijdens het laden van het opgegeven bestand.
Opmerkingen
Een PKCS#12/PFX kan meerdere certificaten bevatten. Met behulp van de volgorde waarin de certificaten worden weergegeven in de resultaten van LoadPkcs12CollectionFromFile(String, 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
LoadPkcs12FromFile(String, String, X509KeyStorageFlags, Pkcs12LoaderLimits)
Hiermee opent u het opgegeven bestand, leest u de inhoud als PKCS#12 PFX en extraheert u een certificaat.
public static System.Security.Cryptography.X509Certificates.X509Certificate2 LoadPkcs12FromFile(string path, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags = System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.DefaultKeySet, System.Security.Cryptography.X509Certificates.Pkcs12LoaderLimits? loaderLimits = default);
static member LoadPkcs12FromFile : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags * System.Security.Cryptography.X509Certificates.Pkcs12LoaderLimits -> System.Security.Cryptography.X509Certificates.X509Certificate2
Public Shared Function LoadPkcs12FromFile (path As String, password As String, Optional keyStorageFlags As X509KeyStorageFlags = System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.DefaultKeySet, Optional loaderLimits As Pkcs12LoaderLimits = Nothing) As X509Certificate2
Parameters
- path
- String
Het pad van het bestand dat moet worden geopend.
- 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
path 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.
Er is een fout opgetreden tijdens het laden van het opgegeven bestand.
Opmerkingen
Een PKCS#12/PFX kan meerdere certificaten bevatten. Met behulp van de volgorde waarin de certificaten worden weergegeven in de resultaten van LoadPkcs12CollectionFromFile(String, 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.