Метод Store.Load

Статья
06/13/2023

[Метод Load доступен для использования в операционных системах, указанных в разделе Требования. Вместо этого используйте класс X509Store в пространстве имен System.Security.Cryptography.X509Certificates .]

Метод Load импортирует сертификаты из файла в хранилище.

Синтаксис

Store.Load( _
  ByVal FileName, _
  [ ByVal Password ], _
  [ ByVal KeyStorageFlag ] _
)

Параметры

FileName [in]

Строка, содержащая путь к CER, SST, SPC, P7S или PFX-файлу или любому файлу со знаком Authenticode.

Пароль [в, необязательно]

Строка, содержащая пароль в виде открытого текста для файла. Для пароля можно использовать до 32 символов Юникода, включая завершающий символ NULL. Сведения о защите пароля см. в разделе Обработка паролей.

KeyStorageFlag [in, необязательно]

Значение перечисления CAPICOM_KEY_STORAGE_FLAG , определяющее флаги хранилища ключей. Значение по умолчанию — CAPICOM_KEY_STORAGE_DEFAULT. Этот параметр может принимать одно из указанных ниже значений.

Значение	Значение
CAPICOM_KEY_STORAGE_DEFAULT	Хранилище ключей по умолчанию.
CAPICOM_KEY_STORAGE_EXPORTABLE	Ключ можно экспортировать.
CAPICOM_KEY_STORAGE_USER_PROTECTED	Ключ защищен пользователем.

Возвращаемое значение

Этот метод не возвращает значение.

Если метод Load вызывается для хранилища памяти, все созданные контейнеры ключей будут удалены при удалении хранилища памяти. Например, если PFX-файл загружается в хранилище памяти, а затем добавляется в системное хранилище (например, Мое хранилище) из хранилища памяти, сертификат в хранилище "Мое" не будет содержать ключа. В этом случае PFX-файл должен быть загружен непосредственно в мое хранилище.

Этот метод вызывает CAPICOM_E_NOT_ALLOWED при создании скрипта из веб-приложения.

Если пароль не может расшифровать файл закрытого ключа, следует запросить поставщика служб шифрования (CSP) по умолчанию. Если поставщик служб шифрования по умолчанию является поставщиком базовых криптографических данных Майкрософт и операция расшифровки завершается сбоем, то операцию расшифровки следует повторить с помощью поставщика шифрования Microsoft Strong Cryptographic Provider или Microsoft Enhanced Cryptographic Provider, в зависимости от того, какой из них доступен.

Если сертификат, загружаемый в хранилище, совпадает с уже существующим, метод Load удалит существующий сертификат из хранилища, а затем добавит новый сертификат. Новый сертификат наследует свойства от существующего сертификата. Существующий контейнер закрытого ключа заменяется новым контейнером закрытых ключей.

Требования

Требование	Значение
Распространяемые компоненты	CAPICOM 2.0 или более поздней версии в Windows Server 2003 и Windows XP
DLL	Capicom.dll

См. также раздел

Магазин