X509CertificateLoader.LoadPkcs12FromFile メソッド

定義

名前空間:

System.Security.Cryptography.X509Certificates

アセンブリ:

System.Security.Cryptography.dll

オーバーロード

LoadPkcs12FromFile(String, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits)	指定したファイルを開き、その内容を PKCS#12 PFX として読み取り、証明書を抽出します。
LoadPkcs12FromFile(String, String, X509KeyStorageFlags, Pkcs12LoaderLimits)	指定したファイルを開き、その内容を PKCS#12 PFX として読み取り、証明書を抽出します。

LoadPkcs12FromFile(String, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits)

指定したファイルを開き、その内容を PKCS#12 PFX として読み取り、証明書を抽出します。

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

パラメーター

path

String

開くファイルのパス。

password

ReadOnlySpan<Char>

PFX の内容を復号化するためのパスワード。

keyStorageFlags

X509KeyStorageFlags

返された証明書に関連付けられている秘密キーをインポートする場所と方法を制御する列挙値のビットごとの組み合わせ。

loaderLimits

Pkcs12LoaderLimits

PFX を読み込むときに適用する制限。 null 値 (既定値) は、Defaultsと同じです。

戻り値

X509Certificate2

読み込まれた証明書。

例外

ArgumentNullException

path は nullです。

ArgumentException

keyStorageFlags 無効な値または値の組み合わせが含まれています。

PlatformNotSupportedException

keyStorageFlags には、現在のプラットフォームで無効な値が含まれています。

Pkcs12LoadLimitExceededException

PKCS#12/PFX は、loaderLimitsの 1 つ以上の制約に違反しました。

CryptographicException

PKCS#12/PFX の読み込み中にエラーが発生しました。

IOException

指定したファイルの読み込み中にエラーが発生しました。

注釈

PKCS#12/PFX には複数の証明書を含めることができます。 このメソッドは、LoadPkcs12CollectionFromFile(String, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits)の結果に証明書が表示される順序を使用して、HasPrivateKey が trueされている最初の証明書を返します。 秘密キーが関連付けられている証明書がない場合は、最初の証明書が返されます。 PKCS#12/PFX に証明書が含まれなければ、CryptographicException がスローされます。

LoadPkcs12FromFile(String, String, X509KeyStorageFlags, Pkcs12LoaderLimits)

指定したファイルを開き、その内容を PKCS#12 PFX として読み取り、証明書を抽出します。

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

パラメーター

path

String

開くファイルのパス。

password

String

PFX の内容を復号化するためのパスワード。

keyStorageFlags

X509KeyStorageFlags

返された証明書に関連付けられている秘密キーをインポートする場所と方法を制御する列挙値のビットごとの組み合わせ。

loaderLimits

Pkcs12LoaderLimits

PFX を読み込むときに適用する制限。 null 値 (既定値) は、Defaultsと同じです。

戻り値

X509Certificate2

読み込まれた証明書。

例外

ArgumentNullException

path は nullです。

ArgumentException

keyStorageFlags 無効な値または値の組み合わせが含まれています。

PlatformNotSupportedException

keyStorageFlags には、現在のプラットフォームで無効な値が含まれています。

Pkcs12LoadLimitExceededException

PKCS#12/PFX は、loaderLimitsの 1 つ以上の制約に違反しました。

CryptographicException

PKCS#12/PFX の読み込み中にエラーが発生しました。

IOException

指定したファイルの読み込み中にエラーが発生しました。

注釈

PKCS#12/PFX には複数の証明書を含めることができます。 このメソッドは、LoadPkcs12CollectionFromFile(String, String, X509KeyStorageFlags, Pkcs12LoaderLimits)の結果に証明書が表示される順序を使用して、HasPrivateKey が trueされている最初の証明書を返します。 秘密キーが関連付けられている証明書がない場合は、最初の証明書が返されます。 PKCS#12/PFX に証明書が含まれなければ、CryptographicException がスローされます。