X509CertificateLoader.LoadPkcs12 Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| LoadPkcs12(Byte[], String, X509KeyStorageFlags, Pkcs12LoaderLimits) |
Carrega os dados fornecidos como um PFX PKCS#12 e extrai um certificado. |
| LoadPkcs12(ReadOnlySpan<Byte>, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits) |
Carrega os dados fornecidos como um PFX PKCS#12 e extrai um certificado. |
LoadPkcs12(Byte[], String, X509KeyStorageFlags, Pkcs12LoaderLimits)
- Origem:
- X509CertificateLoader.cs
Carrega os dados fornecidos como um PFX PKCS#12 e extrai um certificado.
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 X509Certificate2Parâmetros
- data
- Byte[]
Os dados a serem carregados.
- password
- String
A senha para descriptografar o conteúdo do PFX.
- keyStorageFlags
- X509KeyStorageFlags
Uma combinação bit a bit dos valores de enumeração que controlam onde e como importar a chave privada associada ao certificado retornado.
- loaderLimits
- Pkcs12LoaderLimits
Limites a serem aplicados ao carregar o PFX. Um valor null, o padrão, é equivalente a Defaults.
Retornos
O certificado carregado.
Exceções
data é null.
keyStorageFlags contém um valor ou uma combinação de valores que não é válido.
keyStorageFlags contém um valor que não é válido para a plataforma atual.
O PKCS nº 12/PFX violou uma ou mais restrições de loaderLimits.
Erro ao carregar o PKCS nº 12/PFX.
Comentários
Um PKCS#12/PFX pode conter vários certificados. Usando a ordenação que os certificados aparecem nos resultados de LoadPkcs12Collection(ReadOnlySpan<Byte>, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits), esse método retorna o primeiro certificado em que HasPrivateKey é true. Se nenhum certificado tiver chaves privadas associadas, o primeiro certificado será retornado. Se o PKCS nº 12/PFX não contiver certificados, um CryptographicException será gerado.
Aplica-se a
LoadPkcs12(ReadOnlySpan<Byte>, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits)
- Origem:
- X509CertificateLoader.cs
Carrega os dados fornecidos como um PFX PKCS#12 e extrai um certificado.
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 X509Certificate2Parâmetros
- data
- ReadOnlySpan<Byte>
Os dados a serem carregados.
- password
- ReadOnlySpan<Char>
A senha para descriptografar o conteúdo do PFX.
- keyStorageFlags
- X509KeyStorageFlags
Uma combinação bit a bit dos valores de enumeração que controlam onde e como importar a chave privada associada ao certificado retornado.
- loaderLimits
- Pkcs12LoaderLimits
Limites a serem aplicados ao carregar o PFX. Um valor null, o padrão, é equivalente a Defaults.
Retornos
O certificado carregado.
Exceções
data é null.
keyStorageFlags contém um valor ou uma combinação de valores que não é válido.
keyStorageFlags contém um valor que não é válido para a plataforma atual.
O PKCS nº 12/PFX violou uma ou mais restrições de loaderLimits.
Erro ao carregar o PKCS nº 12/PFX.
Comentários
Um PKCS#12/PFX pode conter vários certificados. Usando a ordenação que os certificados aparecem nos resultados de LoadPkcs12Collection(Byte[], String, X509KeyStorageFlags, Pkcs12LoaderLimits), esse método retorna o primeiro certificado em que HasPrivateKey é true. Se nenhum certificado tiver chaves privadas associadas, o primeiro certificado será retornado. Se o PKCS nº 12/PFX não contiver certificados, um CryptographicException será gerado.
