X509CertificateLoader.LoadPkcs12 메서드

정의

네임스페이스:

System.Security.Cryptography.X509Certificates

어셈블리:

System.Security.Cryptography.dll

오버로드

LoadPkcs12(Byte[], String, X509KeyStorageFlags, Pkcs12LoaderLimits)	제공된 데이터를 PKCS#12 PFX로 로드하고 인증서를 추출합니다.
LoadPkcs12(ReadOnlySpan<Byte>, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits)	제공된 데이터를 PKCS#12 PFX로 로드하고 인증서를 추출합니다.

LoadPkcs12(Byte[], String, X509KeyStorageFlags, Pkcs12LoaderLimits)

제공된 데이터를 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.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

매개 변수

data

Byte[]

로드할 데이터입니다.

password

String

PFX의 내용을 해독하는 암호입니다.

keyStorageFlags

X509KeyStorageFlags

반환된 인증서와 연결된 프라이빗 키를 가져오는 위치 및 방법을 제어하는 열거형 값의 비트 조합입니다.

loaderLimits

Pkcs12LoaderLimits

PFX를 로드할 때 적용할 제한입니다. 기본값인 null 값은 Defaults동일합니다.

반환

X509Certificate2

로드된 인증서입니다.

예외

ArgumentNullException

data null.

ArgumentException

keyStorageFlags 유효하지 않은 값 또는 값의 조합을 포함합니다.

PlatformNotSupportedException

keyStorageFlags 현재 플랫폼에 유효하지 않은 값을 포함합니다.

Pkcs12LoadLimitExceededException

PKCS#12/PFX가 하나 이상의 loaderLimits제약 조건을 위반했습니다.

CryptographicException

PKCS#12/PFX를 로드하는 동안 오류가 발생했습니다.

설명

PKCS#12/PFX에는 여러 인증서가 포함될 수 있습니다. 이 메서드는 LoadPkcs12Collection(ReadOnlySpan<Byte>, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits)결과에 인증서가 표시되는 순서를 사용하여 HasPrivateKeytrue첫 번째 인증서를 반환합니다. 연결된 프라이빗 키가 있는 인증서가 없으면 첫 번째 인증서가 반환됩니다. PKCS#12/PFX에 인증서가 없으면 CryptographicException throw됩니다.

LoadPkcs12(ReadOnlySpan<Byte>, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits)

제공된 데이터를 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.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

매개 변수

data

ReadOnlySpan<Byte>

로드할 데이터입니다.

password

ReadOnlySpan<Char>

PFX의 내용을 해독하는 암호입니다.

keyStorageFlags

X509KeyStorageFlags

반환된 인증서와 연결된 프라이빗 키를 가져오는 위치 및 방법을 제어하는 열거형 값의 비트 조합입니다.

loaderLimits

Pkcs12LoaderLimits

PFX를 로드할 때 적용할 제한입니다. 기본값인 null 값은 Defaults동일합니다.

반환

X509Certificate2

로드된 인증서입니다.

예외

ArgumentNullException

data null.

ArgumentException

keyStorageFlags 유효하지 않은 값 또는 값의 조합을 포함합니다.

PlatformNotSupportedException

keyStorageFlags 현재 플랫폼에 유효하지 않은 값을 포함합니다.

Pkcs12LoadLimitExceededException

PKCS#12/PFX가 하나 이상의 loaderLimits제약 조건을 위반했습니다.

CryptographicException

PKCS#12/PFX를 로드하는 동안 오류가 발생했습니다.

설명

PKCS#12/PFX에는 여러 인증서가 포함될 수 있습니다. 이 메서드는 LoadPkcs12Collection(Byte[], String, X509KeyStorageFlags, Pkcs12LoaderLimits)결과에 인증서가 표시되는 순서를 사용하여 HasPrivateKeytrue첫 번째 인증서를 반환합니다. 연결된 프라이빗 키가 있는 인증서가 없으면 첫 번째 인증서가 반환됩니다. PKCS#12/PFX에 인증서가 없으면 CryptographicException throw됩니다.