27.3.2 CAPICOM对象——Certificate对象

Certificate对象就是单个数字证书对象。它包括如下主要的属性。

表 Certificate对象的属性

值	数据类型	权限	意义
Version	Long	只读	证书的版本
SerialNumber	String	只读	证书的序列号，如AA-CC-11-22
SubjectName	String	只读	证书拥有者的主题,如CN=郭靖,U=CCTV,C=CN, L=Beijing,S=Beijing
IssuerName	String	只读	证书颁发者主题，如CN=CNCA,U=CCTV,C=CN,L=Beijing,S=Beijing
ValidFromDate	Date	只读	证书生效日期
ValidToDate	Date	只读	证书失效日期
Thumbprint	String	只读	证书的摘要值

Certificate包括以下主要方法：

1．导出证书方法Export

方法功能：把证书导出转换成某种编码的字符串。该字符串可以保存到文件或者导入到新的Certificate对象中。

方法定义：

[Visual Basic]

ObjectName.Export(

  EncodingType as CAPICOM_ENCODING_TYPE

) as String

参数说明：

q      EncodingType：[IN] 证书导出的格式，CAPICOM_ENCODE_BASE64（0）表示Base64编码格式，CAPICOM_ENCODE_BINARY（1）表示DER编码的二进制格式。默认是Base64编码格式。

返回值：String类型的某一特定编码格式的证书数据

2．读取证书信息方法GetInfo

方法功能：功能获取证书某一特定信息。

方法定义：

[Visual Basic]

ObjectName.GetInfo(

  InfoType as CAPICOM_CERT_INFO_TYPE

) as String

参数说明：

q      InfoType：[IN] 获取证书信息的类型。

表 InfoType支持的参数

值	意义
CAPICOM_INFO_SUBJECT_SIMPLE_NAME 0	证书拥有者主题
CAPICOM_INFO_ISSUER_SIMPLE_NAME 1	证书颁发者主题
CAPICOM_INFO_SUBJECT_EMAIL_NAME 2	证书拥有者email
CAPICOM_INFO_ISSUER_EMAIL_NAME 3	证书颁发者email

返回值：String类型的证书信息

3．是否用于私钥方法HasPrivateKey

方法功能：判断该证书是否拥有私钥。一般存储在个人区的证书拥有私钥。

方法定义：

Visual Basic]

ObjectName.HasPrivateKey(

) as Boolean

返回值：Boolean类型，拥有私钥返回TRUE，否则返回FALSE。

4．导入证书方法Import

方法功能：把字符串导入到证书中。

方法定义：

[Visual Basic]

ObjectName.Import(

  EncodedCertificate as String

)

参数说明：

q      EncodedCertificate：[IN] 导入证书的字符串。

返回值：无

5．证书是否有效方法IsValid

方法功能：判断证书有效性，返回CertificateStatus对象。

方法定义：

[Visual Basic]

ObjectName.IsValid(

) as CertificateStatus

返回值：CertificateStatus对象数据类型。对其的介绍详见（3）CertificateStatus对象的介绍。

6．获得证书用户属性方法KeyUsage

方法功能：获得证书用途属性信息，返回证书的KeyUsage对象。

[Visual Basic]

ObjectName.KeyUsage(

) as KeyUsage

返回值：KeyUsage对象数据类型。对其的介绍详见KeyUsage对象的介绍。