KeyStore.GetInstance Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| Имя. | Описание |
|---|---|
| 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 "Хранилище ключей" в спецификации имен алгоритмов безопасности уровня "Стандартный".
- provider
- Provider
поставщик.
Возвращаемое значение
объект хранилища ключей указанного типа
- Атрибуты
Исключения
Значение , если во время создания нового KeyStoreпроизошла ошибка.
Значение
if type == null (вместо NoSuchAlgorithmException) как в выпуске 1.4
Комментарии
Возвращает объект хранилища ключей указанного типа.
Возвращается новый объект KeyStore, инкапсулирующий реализацию KeyStoreSpi из указанного объекта Provider. Обратите внимание, что указанный объект provider не должен быть зарегистрирован в списке поставщиков.
Добавлено в версии 1.4.
Java документации по java.security.KeyStore.getInstance(java.lang.String, java.security.Provider).
Части этой страницы — это изменения на основе работы, созданной и общей Project и используемых в соответствии с условиями, описанными в разделе "".
См. также
Применяется к
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 метод, чтобы определить, поддерживает ли он указанный хранилище ключей. Возвращается новый объект KeyStore, который инкапсулирует реализацию KeyStoreSpi от первого поставщика, поддерживающего указанный файл.
Обратите внимание, что список зарегистрированных поставщиков можно получить с помощью Security#getProviders() Security.getProviders() метода.
Добавлено в 9.
Java документации по java.security.KeyStore.getInstance(java.io.File, char[]).
Части этой страницы — это изменения на основе работы, созданной и общей Project и используемых в соответствии с условиями, описанными в разделе "".
Применяется к
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 "Хранилище ключей" в спецификации имен алгоритмов безопасности уровня "Стандартный".
- provider
- String
имя поставщика.
Возвращаемое значение
объект хранилища ключей указанного типа
- Атрибуты
Исключения
Значение , если во время создания нового KeyStoreпроизошла ошибка.
Значение , если указанный поставщик недоступен.
если provider == null || provider.isEmpty()
If type is null (вместо NoSuchAlgorithmException), как в выпуске 1.4
Комментарии
Возвращает объект хранилища ключей указанного типа.
Возвращается новый объект KeyStore, инкапсулирующий реализацию KeyStoreSpi из указанного поставщика. Указанный поставщик должен быть зарегистрирован в списке поставщиков безопасности.
Обратите внимание, что список зарегистрированных поставщиков можно получить с помощью Security#getProviders() Security.getProviders() метода.
Java документации по java.security.KeyStore.getInstance(java.lang.String, java.lang.String).
Части этой страницы — это изменения на основе работы, созданной и общей Project и используемых в соответствии с условиями, описанными в разделе "".
См. также
Применяется к
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произошла ошибка.
если type == null
Комментарии
Возвращает объект хранилища ключей указанного типа.
Этот метод проходит по списку зарегистрированных поставщиков безопасности, начиная с наиболее предпочтительного поставщика. Новый объект KeyStore, инкапсулирующий реализацию KeyStoreSpi от первого поставщика, поддерживающего указанный тип, возвращается.
Обратите внимание, что список зарегистрированных поставщиков можно получить с помощью Security#getProviders() Security.getProviders() метода.
Java документации по java.security.KeyStore.getInstance(java.lang.String).
Части этой страницы — это изменения на основе работы, созданной и общей Project и используемых в соответствии с условиями, описанными в разделе "".
См. также
Применяется к
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.
- Атрибуты
Исключения
Если поставщик не поддерживает реализацию KeyStoreSpi для file.
Если данные хранилища ключей имеют проблему ввода-вывода или форматирования, включая неправильный параметр защиты; в последнем случае причина является UnrecoverableKeyExceptionпричиной.
Если алгоритм, используемый для проверки целостности хранилища ключей, не найден.
Если сертификат в хранилище ключей не может быть загружен.
Если file файл не существует или не является нормальным, или если param не является распознаваемым параметром load/store.
Если file имеет значение null.
Комментарии
Поставщики проверяются в порядке предпочтения. Каждая реализация, поддерживаемая KeyStoreSpi поставщиком, используется engineProbe для определения того, поддерживает ли он файл. Затем этот метод создает и возвращает хранилище ключей, которое инкапсулирует первую реализацию SPI, поддерживающую файл.