Метод ICertificate2::Save

  • Статья

[CAPICOM — это 32-разрядный компонент, доступный для использования в следующих операционных системах: Windows Server 2008, Windows Vista и Windows XP. Вместо этого используйте класс X509Certificate2 в пространстве имен System.Security.Cryptography.X509Certificates .]

Метод Save сохраняет сертификат в файл. Этот метод появился в CAPICOM 2.0.

Синтаксис

Certificate.Save( _
  ByVal FileName, _
  [ ByVal Password ], _
  [ ByVal SaveAs ], _
  [ ByVal IncludeOption ] _
)

Параметры

FileName [in]

Строка, содержащая имя выходного файла, в котором будет сохранен сертификат.

Пароль [in, optional]

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

SaveAs [in, optional]

Значение перечисления CAPICOM_CERTIFICATE_SAVE_AS_TYPE , указывающее формат выходного файла. Значение по умолчанию — CAPICOM_CERTIFICATE_SAVE_AS_CER. В следующей таблице приводятся возможные значения.

Значение Значение
CAPICOM_CERTIFICATE_SAVE_AS_CER
 Выходной файл будет отформатирован как CER-файл без сохранения закрытых ключей.
CAPICOM_CERTIFICATE_SAVE_AS_PFX
 Выходной файл будет отформатирован как PFX-файл (PKCS #12), а также будут сохранены все связанные закрытые ключи, которые можно экспортировать.

 

IncludeOption [in, optional]

Значение перечисления CAPICOM_CERTIFICATE_INCLUDE_OPTION , указывающее, сколько сертификатов в цепочке сохраняются в выходном файле. Значение по умолчанию — CAPICOM_CERTIFICATE_INCLUDE_END_ENTITY_ONLY. В следующей таблице приводятся возможные значения.

Значение Значение
CAPICOM_CERTIFICATE_INCLUDE_CHAIN_EXCEPT_ROOT
 Сохраняет все сертификаты в цепочке за исключением корневой сущности.
CAPICOM_CERTIFICATE_INCLUDE_WHOLE_CHAIN
 Сохраняет полную цепочку сертификатов
CAPICOM_CERTIFICATE_INCLUDE_END_ENTITY_ONLY
 Сохраняет только сертификат конечной сущности.

 

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

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

Комментарии

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

Требования

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