KeyStore.GetInstance メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| 名前 | 説明 |
|---|---|
| GetInstance(String, Provider) |
指定した型のキーストア オブジェクトを返します。 |
| GetInstance(File, Char[]) |
適切なキーストア型の読み込まれたキーストア オブジェクトを返します。 |
| GetInstance(String, String) |
指定した型のキーストア オブジェクトを返します。 |
| GetInstance(String) |
指定した型のキーストア オブジェクトを返します。 |
| GetInstance(File, KeyStore+ILoadStoreParameter) |
キーストア ファイルをプローブし、検出された型の読み込まれたキーストアを返します。 |
GetInstance(String, Provider)
指定した型のキーストア オブジェクトを返します。
[Android.Runtime.Register("getInstance", "(Ljava/lang/String;Ljava/security/Provider;)Ljava/security/KeyStore;", "")]
public static Java.Security.KeyStore? GetInstance(string? type, Java.Security.Provider? provider);
[<Android.Runtime.Register("getInstance", "(Ljava/lang/String;Ljava/security/Provider;)Ljava/security/KeyStore;", "")>]
static member GetInstance : string * Java.Security.Provider -> Java.Security.KeyStore
パラメーター
- type
- String
キーストアの種類。 標準キーストアの種類については、「Java セキュリティ標準アルゴリズム名の仕様」の「KeyStore」セクションを参照してください。
- provider
- Provider
プロバイダー。
返品
指定した型のキーストア オブジェクト
- 属性
例外
新しい KeyStoreの作成時にエラーが発生した場合。
providerがnullまたは空の文字列の場合。
1.4 リリースのように (NoSuchAlgorithmException ではなく) type == null 場合
注釈
指定した型のキーストア オブジェクトを返します。
指定したプロバイダー オブジェクトから KeyStoreSpi 実装をカプセル化する新しい KeyStore オブジェクトが返されます。 指定した Provider オブジェクトをプロバイダー一覧に登録する必要はありません。
1.4 で追加されました。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
こちらもご覧ください
適用対象
GetInstance(File, Char[])
適切なキーストア型の読み込まれたキーストア オブジェクトを返します。
[Android.Runtime.Register("getInstance", "(Ljava/io/File;[C)Ljava/security/KeyStore;", "", ApiSince=33)]
public static Java.Security.KeyStore? GetInstance(Java.IO.File? file, char[]? password);
[<Android.Runtime.Register("getInstance", "(Ljava/io/File;[C)Ljava/security/KeyStore;", "", ApiSince=33)>]
static member GetInstance : Java.IO.File * char[] -> Java.Security.KeyStore
パラメーター
- file
- File
キーストア ファイル
- password
- Char[]
キーストアのパスワードを指定します。このパスワードは、次の場合があります。 null
返品
キーストア データが読み込まれたキーストア オブジェクト
- 属性
注釈
適切なキーストア型の読み込まれたキーストア オブジェクトを返します。 最初に、キーストアの種類は、指定されたファイルをプローブすることによって決定されます。 その後、キーストア オブジェクトがインスタンス化され、そのファイルのデータを使用して読み込まれます。
鍵ストアのロックを解除したり (鍵ストアがハードウェア・トークン・デバイスに存在する場合など)、鍵ストア・データの整合性を確認したりするために、パスワードを指定できます。 整合性チェック用のパスワードが指定されていない場合、整合性チェックは実行されません。
このメソッドは、登録されているセキュリティ プロバイダー プロバイダーの一覧を、最も優先されるプロバイダーから順に走査します。 プロバイダーによってサポートされる KeyStoreSpi 実装ごとに、 KeyStoreSpi#engineProbe(InputStream) engineProbe メソッドを呼び出して、指定されたキーストアがサポートされているかどうかを判断します。 指定したファイルをサポートする最初のプロバイダーからの KeyStoreSpi 実装をカプセル化する新しい KeyStore オブジェクトが返されます。
登録済みプロバイダーの一覧は、 Security#getProviders() Security.getProviders() メソッドを使用して取得できます。
9 に追加されました。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
適用対象
GetInstance(String, String)
指定した型のキーストア オブジェクトを返します。
[Android.Runtime.Register("getInstance", "(Ljava/lang/String;Ljava/lang/String;)Ljava/security/KeyStore;", "")]
public static Java.Security.KeyStore? GetInstance(string? type, string? provider);
[<Android.Runtime.Register("getInstance", "(Ljava/lang/String;Ljava/lang/String;)Ljava/security/KeyStore;", "")>]
static member GetInstance : string * string -> Java.Security.KeyStore
パラメーター
- type
- String
キーストアの種類。 標準キーストアの種類については、「Java セキュリティ標準アルゴリズム名の仕様」の「KeyStore」セクションを参照してください。
- provider
- String
プロバイダーの名前。
返品
指定した型のキーストア オブジェクト
- 属性
例外
新しい KeyStoreの作成時にエラーが発生した場合。
指定したプロバイダーが使用できない場合は 。
もし provider == null || provider.isEmpty()
typeが 1.4 リリースのように (NoSuchAlgorithmException ではなく) nullされている場合
注釈
指定した型のキーストア オブジェクトを返します。
指定したプロバイダーからの KeyStoreSpi 実装をカプセル化する新しい KeyStore オブジェクトが返されます。 指定したプロバイダーは、セキュリティ プロバイダーの一覧に登録する必要があります。
登録済みプロバイダーの一覧は、 Security#getProviders() Security.getProviders() メソッドを使用して取得できます。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
こちらもご覧ください
適用対象
GetInstance(String)
指定した型のキーストア オブジェクトを返します。
[Android.Runtime.Register("getInstance", "(Ljava/lang/String;)Ljava/security/KeyStore;", "")]
public static Java.Security.KeyStore? GetInstance(string? type);
[<Android.Runtime.Register("getInstance", "(Ljava/lang/String;)Ljava/security/KeyStore;", "")>]
static member GetInstance : string -> Java.Security.KeyStore
パラメーター
- type
- String
キーストアの種類。 標準キーストアの種類については、「Java セキュリティ標準アルゴリズム名の仕様」の「KeyStore」セクションを参照してください。
返品
指定した型のキーストア オブジェクト
- 属性
例外
新しい KeyStoreの作成時にエラーが発生した場合。
もし type == null
注釈
指定した型のキーストア オブジェクトを返します。
このメソッドは、登録されているセキュリティ プロバイダーの一覧を、最も優先されるプロバイダーから順に走査します。 指定した型をサポートする最初のプロバイダーからの KeyStoreSpi 実装をカプセル化する新しい KeyStore オブジェクトが返されます。
登録済みプロバイダーの一覧は、 Security#getProviders() Security.getProviders() メソッドを使用して取得できます。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
こちらもご覧ください
適用対象
GetInstance(File, KeyStore+ILoadStoreParameter)
キーストア ファイルをプローブし、検出された型の読み込まれたキーストアを返します。
[Android.Runtime.Register("getInstance", "(Ljava/io/File;Ljava/security/KeyStore$LoadStoreParameter;)Ljava/security/KeyStore;", "", ApiSince=33)]
public static Java.Security.KeyStore? GetInstance(Java.IO.File? file, Java.Security.KeyStore.ILoadStoreParameter? param);
[<Android.Runtime.Register("getInstance", "(Ljava/io/File;Ljava/security/KeyStore$LoadStoreParameter;)Ljava/security/KeyStore;", "", ApiSince=33)>]
static member GetInstance : Java.IO.File * Java.Security.KeyStore.ILoadStoreParameter -> Java.Security.KeyStore
パラメーター
- file
- File
プローブして読み込むキーストア ファイル。
キーストアのロックを解除する方法、またはその整合性を確認する方法を指定する省略可能なパラメーター。
返品
file内のデータで初期化されたキーストア。
- 属性
例外
プロバイダーがfileのKeyStoreSpi実装をサポートしていない場合。
キーストア データに I/O または形式の問題がある場合 (不適切な保護パラメーターを含む)。後者の場合、原因は UnrecoverableKeyExceptionです。
鍵ストアの整合性の確認に使用されたアルゴリズムが見つからない場合。
キーストア内の証明書を読み込むことができない場合。
fileが存在しない場合、または通常のファイルでない場合、またはparamが認識された load/store パラメーターでない場合。
fileがnullの場合。
注釈
プロバイダーは優先順にチェックされます。 プロバイダーでサポートされる各 KeyStoreSpi 実装では、 engineProbe を使用して、ファイルがサポートされているかどうかを判断します。 次に、このメソッドは、ファイルをサポートする最初の SPI 実装をカプセル化するキーストアを構築して返します。