X509CertificateLoader.LoadPkcs12 Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| LoadPkcs12(Byte[], String, X509KeyStorageFlags, Pkcs12LoaderLimits) |
Загружает предоставленные данные в виде PKCS#12 PFX и извлекает сертификат. |
| LoadPkcs12(ReadOnlySpan<Byte>, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits) |
Загружает предоставленные данные в виде PKCS#12 PFX и извлекает сертификат. |
LoadPkcs12(Byte[], String, X509KeyStorageFlags, Pkcs12LoaderLimits)
- Исходный код:
- X509CertificateLoader.cs
Загружает предоставленные данные в виде PKCS#12 PFX и извлекает сертификат.
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.X509Certificate2Public 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Параметры
- data
- Byte[]
Данные для загрузки.
- password
- String
Пароль для расшифровки содержимого PFX.
- keyStorageFlags
- X509KeyStorageFlags
Побитовое сочетание значений перечисления, которые управляют местом и как импортировать закрытый ключ, связанный с возвращенным сертификатом.
- loaderLimits
- Pkcs12LoaderLimits
Ограничения, применяемые при загрузке PFX. Значение null по умолчанию эквивалентно Defaults.
Возвращаемое значение
Загруженный сертификат.
Исключения
data
null.
keyStorageFlags содержит значение или сочетание значений, которое недопустимо.
keyStorageFlags содержит значение, недопустимое для текущей платформы.
PKCS#12/PFX нарушил одно или несколько ограничений loaderLimits.
Произошла ошибка при загрузке PKCS#12/PFX.
Комментарии
PKCS#12/PFX может содержать несколько сертификатов. Используя порядок, который сертификаты отображаются в результатах LoadPkcs12Collection(ReadOnlySpan<Byte>, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits), этот метод возвращает первый сертификат, в котором HasPrivateKeytrue. Если сертификаты не имеют связанных закрытых ключей, возвращается первый сертификат. Если PKCS#12/PFX не содержит сертификатов, создается CryptographicException.
Применяется к
LoadPkcs12(ReadOnlySpan<Byte>, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits)
- Исходный код:
- X509CertificateLoader.cs
Загружает предоставленные данные в виде PKCS#12 PFX и извлекает сертификат.
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.X509Certificate2Public 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Параметры
- data
- ReadOnlySpan<Byte>
Данные для загрузки.
- password
- ReadOnlySpan<Char>
Пароль для расшифровки содержимого PFX.
- keyStorageFlags
- X509KeyStorageFlags
Побитовое сочетание значений перечисления, которые управляют местом и как импортировать закрытый ключ, связанный с возвращенным сертификатом.
- loaderLimits
- Pkcs12LoaderLimits
Ограничения, применяемые при загрузке PFX. Значение null по умолчанию эквивалентно Defaults.
Возвращаемое значение
Загруженный сертификат.
Исключения
data
null.
keyStorageFlags содержит значение или сочетание значений, которое недопустимо.
keyStorageFlags содержит значение, недопустимое для текущей платформы.
PKCS#12/PFX нарушил одно или несколько ограничений loaderLimits.
Произошла ошибка при загрузке PKCS#12/PFX.
Комментарии
PKCS#12/PFX может содержать несколько сертификатов. Используя порядок, который сертификаты отображаются в результатах LoadPkcs12Collection(Byte[], String, X509KeyStorageFlags, Pkcs12LoaderLimits), этот метод возвращает первый сертификат, в котором HasPrivateKeytrue. Если сертификаты не имеют связанных закрытых ключей, возвращается первый сертификат. Если PKCS#12/PFX не содержит сертификатов, создается CryptographicException.
