Certificate 物件
[CAPICOM 是 32 位的僅限元件，可用於下列作業系統：Windows Server 2008、Windows Vista 和 Windows XP。 請改用System.Security.Cryptography.X509Certificates命名空間中的X509Certificate2 類別。]
Certificate物件代表單一數位憑證。
Certificate物件會公開下列介面：
- ICertificate - 在 CAPICOM 1.0 中引進。
- ICertificate2 - 在 CAPICOM 2.0 中引進。
使用時機
Certificate物件可用來執行下列工作：
- 從檔案載入憑證資料，包括私密金鑰。
- 從憑證取得資訊。
- 傳回與憑證相關聯的基本條件約束、EKU、擴充屬性、延伸模組、金鑰使用方式、公開金鑰和範本物件。
- 判斷憑證是否有效，並檢查憑證主體私密金鑰的存取可用性。
- 顯示憑證。
- 匯入和匯出憑證。
- 將憑證儲存至檔案。
- 擷取或設定描述憑證的屬性。
成員
Certificate物件具有下列類型的成員：
方法
Certificate物件具有這些方法。
| 方法 | Description |
|---|---|
| BasicConstraints | 會傳回 BasicConstraints 物件，代表憑證的基本條件約束延伸。 (繼承自 CertificateICertificate2ICertificate) |
| 顯示器 | 顯示憑證。 (繼承自 CertificateICertificate2ICertificate) |
| 出口 | 將憑證複製到編碼字串。 編碼字串可以寫入檔案或匯入新的 Certificate 物件。 (繼承自 CertificateICertificate2ICertificate) |
| ExtendedKeyUsage | 會傳回 ExtendedKeyUsage 物件，指出憑證的有效擴充金鑰用法。 (繼承自 CertificateICertificate2ICertificate) |
| ExtendedProperties | 傳回憑證擴充屬性的集合。 (繼承自 CertificateICertificate2) |
| 延伸模組 | 傳回與憑證相關聯的延伸模組集合。 (繼承自 CertificateICertificate2) |
| GetInfo | 從憑證擷取資訊。 (繼承自 CertificateICertificate2ICertificate) |
| HasPrivateKey | 判斷憑證是否有與其相關聯的 私密金鑰 。 (繼承自 CertificateICertificate2ICertificate) |
| 匯入 | 將先前編碼的憑證從字串匯入 Certificate 物件。 (繼承自 CertificateICertificate2ICertificate) |
| IsValid | 建置憑證的憑證驗證鏈結，並傳回 CertificateStatus 物件，其中包含憑證的有效性狀態。 (繼承自 CertificateICertificate2ICertificate) |
| KeyUsage | 會傳回 KeyUsage 物件，指出憑證的有效金鑰使用方式。 (繼承自 CertificateICertificate2ICertificate) |
| 載入 | 從檔案匯入憑證。 (繼承自 CertificateICertificate2) |
| PublicKey | 會傳回 PublicKey 物件。 (繼承自 CertificateICertificate2) |
| 儲存 | 將憑證儲存至檔案。 (繼承自 CertificateICertificate2) |
| [範本] | 傳回與憑證相關聯的範本。 (繼承自 CertificateICertificate2) |
屬性
Certificate物件具有這些屬性。
| 屬性 | 存取類型 | Description |
|---|---|---|
|
Archived |
讀取/寫入 |
設定或擷取布林值，指出憑證是否已封存。 (繼承自 CertificateICertificate2) |
|
IssuerName |
唯讀 |
擷取包含憑證簽發者名稱的字串。 (繼承自 CertificateICertificate2ICertificate) |
|
PrivateKey |
讀取/寫入 |
設定或擷取與憑證相關聯的私密金鑰。 (繼承自 CertificateICertificate2) |
|
SerialNumber |
唯讀 |
擷取包含憑證序號的字串。 (繼承自 CertificateICertificate2ICertificate) |
|
SubjectName |
唯讀 |
擷取包含憑證主體名稱的字串。 (繼承自 CertificateICertificate2ICertificate) |
|
指紋 |
唯讀 |
擷取包含憑證 SHA-1 雜湊的十六進位字串。 (繼承自 CertificateICertificate2ICertificate) |
|
ValidFromDate |
唯讀 |
擷取憑證有效性的開始日期。 (繼承自 CertificateICertificate2ICertificate) |
|
ValidToDate |
唯讀 |
擷取憑證有效性的結束日期。 (繼承自 CertificateICertificate2ICertificate) |
|
版本 |
唯讀 |
擷取憑證的版本號碼。 (繼承自 CertificateICertificate2ICertificate) |
備註
您可以建立 Certificate 物件，而且可以安全地編寫腳本。 Certificate物件的 ProgID 是 「CAPICOM。Certificate.2」。
CAPICOM 1.x：Certificate物件的 ProgID 是 「CAPICOM。Certificate.1」。
規格需求
| 需求 | 值 |
|---|---|
| 用戶端支援結束 |
Windows Vista |
| 伺服器終止支援 |
Windows Server 2008 |
| 可轉散發套件 |
Windows Server 2003 和 Windows XP 上的 CAPICOM 2.0 或更新版本 |
| DLL |
|