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对象的介绍。