ICertificate2::Save 方法

[CAPICOM 是一个仅限 32 位的组件,可用于以下操作系统:Windows Server 2008、Windows Vista 和 Windows XP。 请改用 System.Security.Cryptography.X509Certificates 命名空间中的 X509Certificate2。]

Save 方法将证书保存到文件中。 此方法是在 CAPICOM 2.0 中引入的。

语法

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

参数

FileName [in]

一个字符串,其中包含将保存证书的输出文件的名称。

密码 [in,可选]

包含私钥文件的纯文本密码的字符串。 密码最多可包含 32 个 Unicode 字符,包括终止 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
仅保存最终实体证书

 

返回值

此方法不返回值。

备注

此方法在从基于 Web 的应用程序编写脚本时引发CAPICOM_E_NOT_ALLOWED。

要求

要求
终止客户端支持
Windows Vista
终止服务器支持
Windows Server 2008
可再发行组件
Windows Server 2003 和 Windows XP 上的 CAPICOM 2.0 或更高版本
DLL
Capicom.dll