X509CertificateLoader.LoadPkcs12 Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
LoadPkcs12(Byte[], String, X509KeyStorageFlags, Pkcs12LoaderLimits) |
Charge les données fournies sous forme de PFX PKCS#12 et extrait un certificat. |
LoadPkcs12(ReadOnlySpan<Byte>, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits) |
Charge les données fournies sous forme de PFX PKCS#12 et extrait un certificat. |
LoadPkcs12(Byte[], String, X509KeyStorageFlags, Pkcs12LoaderLimits)
- Source:
- X509CertificateLoader.cs
Charge les données fournies sous forme de PFX PKCS#12 et extrait un certificat.
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
Paramètres
- data
- Byte[]
Données à charger.
- password
- String
Mot de passe pour déchiffrer le contenu du PFX.
- keyStorageFlags
- X509KeyStorageFlags
Combinaison de bits des valeurs d’énumération qui contrôlent où et comment importer la clé privée associée au certificat retourné.
- loaderLimits
- Pkcs12LoaderLimits
Limites à appliquer lors du chargement du PFX. Une valeur null
, la valeur par défaut, équivaut à Defaults.
Retours
Certificat chargé.
Exceptions
data
est null
.
keyStorageFlags
contient une valeur ou une combinaison de valeurs qui n’est pas valide.
keyStorageFlags
contient une valeur qui n’est pas valide pour la plateforme actuelle.
Le PKCS#12/PFX a violé une ou plusieurs contraintes de loaderLimits
.
Une erreur s’est produite lors du chargement de PKCS#12/PFX.
Remarques
Un PKCS#12/PFX peut contenir plusieurs certificats. À l’aide de l’ordre dans lequel les certificats apparaissent dans les résultats de LoadPkcs12Collection(ReadOnlySpan<Byte>, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits), cette méthode retourne le premier certificat où HasPrivateKey est true
. Si aucun certificat n’a de clés privées associées, le premier certificat est retourné. Si PKCS#12/PFX ne contient aucun certificat, une CryptographicException est levée.
S’applique à
LoadPkcs12(ReadOnlySpan<Byte>, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits)
- Source:
- X509CertificateLoader.cs
Charge les données fournies sous forme de PFX PKCS#12 et extrait un certificat.
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
Paramètres
- data
- ReadOnlySpan<Byte>
Données à charger.
- password
- ReadOnlySpan<Char>
Mot de passe pour déchiffrer le contenu du PFX.
- keyStorageFlags
- X509KeyStorageFlags
Combinaison de bits des valeurs d’énumération qui contrôlent où et comment importer la clé privée associée au certificat retourné.
- loaderLimits
- Pkcs12LoaderLimits
Limites à appliquer lors du chargement du PFX. Une valeur null
, la valeur par défaut, équivaut à Defaults.
Retours
Certificat chargé.
Exceptions
data
est null
.
keyStorageFlags
contient une valeur ou une combinaison de valeurs qui n’est pas valide.
keyStorageFlags
contient une valeur qui n’est pas valide pour la plateforme actuelle.
Le PKCS#12/PFX a violé une ou plusieurs contraintes de loaderLimits
.
Une erreur s’est produite lors du chargement de PKCS#12/PFX.
Remarques
Un PKCS#12/PFX peut contenir plusieurs certificats. À l’aide de l’ordre dans lequel les certificats apparaissent dans les résultats de LoadPkcs12Collection(Byte[], String, X509KeyStorageFlags, Pkcs12LoaderLimits), cette méthode retourne le premier certificat où HasPrivateKey est true
. Si aucun certificat n’a de clés privées associées, le premier certificat est retourné. Si PKCS#12/PFX ne contient aucun certificat, une CryptographicException est levée.