憑證要求函式
CertEnroll.dll程式庫會實作五個介面，可用來建立和管理憑證要求。 在這些情況下， IX509CertificateRequest 介面代表抽象基底物件，定義下列四個介面所繼承的方法簽章。
| 介面 | 描述 |
|---|---|
| IX509CertificateRequestCertificate | 可讓您直接建立憑證，而不需要套用至 憑證授權單位單位 (CA) 。 |
| IX509CertificateRequestCmc | 代表 透過 CMS (CMC 的憑證管理，) (CMS 的憑證管理訊息，) 憑證要求，其中包含巢狀 PKCS #10 要求或其他 CMC 要求物件。 |
| IX509CertificateRequestPkcs7 | 表示 PKCS #7 憑證訊息語法， (CMS) 要求物件，該物件必須包含巢狀 PKCS #10 要求。 |
| IX509CertificateRequestPkcs10 | 表示 PKCS #10 憑證要求。 PKCS #10 要求可以直接傳送至 CA，也可以由 PKCS #7 或 CMC 要求包裝。 |
您可以使用憑證要求物件初始化 IX509Enrollment 物件，在憑證階層中註冊用戶端，並安裝 CA 傳回的憑證回應。
下列各節會識別Xenroll.dll匯出的函式，以建立、列舉或刪除憑證要求。 每個章節也會討論如何使用 CertEnroll.dll 來取代 函式，或指出兩個程式庫之間沒有任何對應存在：
- createFilePKCS10WStr
- createFileRequestWStr
- createPKCS10WStr
- CreatePKCS7RequestFromRequest
- createRequestWStr
- DeleteRequestCert
- enumPendingRequestWStr
- removePendingRequestWStr
- 重設
- setPendingRequestInfoWStr
- 相關主題
createFilePKCS10WStr
Xenroll.dll中的 createFilePKCS10WStr 函 式會建立 base64 編碼的 PKCS #10 憑證要求，並將它儲存在檔案中。
CertEnroll.dll程式庫不會直接實作將要求寫入檔案的功能。 不過，您可以在IX509CertificateRequest物件上呼叫RawData屬性，並建立自訂函式以將值複製到檔案，以擷取憑證要求。
createFileRequestWStr
Xenroll.dll中的 createFileRequestWStr 函式會建立 PKCS #7、PKCS #10 或 CMC 憑證要求，並將它儲存在檔案中。
CertEnroll.dll程式庫不會直接實作將要求寫入檔案的功能。 不過，您可以在IX509CertificateRequest物件上呼叫RawData屬性，並建立自訂函式以將值複製到檔案，以擷取憑證要求。
createPKCS10WStr
Xenroll.dll中的 createPKCS10WStr 函 式會建立 PKCS #10 憑證要求，並將它複製到位元組陣列。
您可以使用 IX509CertificateRequestPkcs10 物件，從現有要求、現有憑證、 私密金鑰、 公開金鑰或範本初始化 PKCS #10 要求。
CreatePKCS7RequestFromRequest
Xenroll.dll中的 CreatePKCS7RequestFromRequest 函式會建立 PKCS #7 憑證要求，並將它複製到位元組陣列。
您可以使用 IX509CertificateRequestPkcs7 物件，從現有要求、現有憑證、內部要求物件或範本初始化 PKCS #7 要求。
createRequestWStr
Xenroll.dll中的 createRequestWStr 函式會建立 PKCS #7、PKCS #10 或 CMC 憑證要求，並將它複製到位元組陣列。
若要使用CertEnroll.dll程式庫來建立 PKCS #7、PKCS #10 或 CMC 要求，您可以建立和初始化 IX509CertificateRequestPkcs7、 IX509CertificateRequestPkcs10或 IX509CertificateRequestCmc 物件的實例。
DeleteRequestCert
Xenroll.dll中的 DeleteRequestCert 函式會指定或擷取布林值，指出是否已在安裝憑證回應之後移除虛擬憑證。
CertEnroll.dll中的 IX509Enrollment 物件會自動在要求存放區中建立虛擬憑證，以暫時儲存在註冊程式期間初始化的各種憑證屬性。 CA 發行憑證之後，屬性會複製到新的憑證，並刪除虛擬憑證。 CertEnroll.dll程式庫不允許在安裝憑證回應之後強制保留虛擬憑證。
enumPendingRequestWStr
Xenroll.dll中的 enumPendingRequestWStr 函式會擷取暫止要求的指定屬性值。
CertEnroll.dll程式庫不會直接實作移除擱置憑證要求的功能。
removePendingRequestWStr
Xenroll.dll中的 removePendingRequestWStr 函 式會從要求存放區中移除擱置的要求。
CertEnroll.dll程式庫不會直接實作移除擱置憑證要求的功能。
重設
Xenroll.dll中的 Reset 函式會將憑證註冊控制傳回初始狀態。
您可以使用Certenroll.dll來建立必要類型的新要求物件，以達到相同的結果。
setPendingRequestInfoWStr
Xenroll.dll中的 setPendingRequestInfoWStr 函式會指定擱置要求的屬性。
CertEnroll.dll程式庫不會直接實作移除擱置憑證要求的功能。 您可以在IX509Enrollment物件上呼叫CAConfigString屬性，以擷取組態字串，但僅適用于作用中的註冊物件。
相關主題
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應