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 |
|