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對象的介紹。