共用方式為

IX509CertificateRequestPkcs10V2：：InitializeFromTemplate 方法 (certenroll.h)

  • 發行項

InitializeFromTemplate 方法會使用範本來初始化憑證要求。

語法

HRESULT InitializeFromTemplate(
  [in] X509CertificateEnrollmentContext context,
  [in] IX509EnrollmentPolicyServer      *pPolicyServer,
  [in] IX509CertificateTemplate         *pTemplate
);

參數

[in] context

X509CertificateEnrollmentContext 列舉值，指定要求的憑證是否適用於代表計算機的使用者、計算機或系統管理員。 這可以是下列其中一個值。

值 意義
ContextUser
 正在要求終端用戶的憑證。
ContextMachine
 正在要求計算機的憑證。
ContextAdministratorForceMachine
 系統管理員正在代表計算機要求憑證。

[in] pPolicyServer

IX509EnrollmentPolicyServer 物件的指標，代表包含 pTemplate 參數所指定範本的憑證註冊原則 (CEP) 伺服器。

[in] pTemplate

IX509CertificateTemplate 物件的指標，代表初始化期間要使用的範本。

傳回值

如果函式成功，函式會傳回 S_OK。

如果函式失敗，它會傳回 指出錯誤的 HRESULT 值。 可能的值包括 (但不限於) 下表中的這些值。 如需常見錯誤碼的清單，請參閱 一般 HRESULT 值。

傳回碼 Description
E_POINTER
 pPolicyServer 或 pTemplate 參數為 NULL。
HRESULT_FROM_WIN32 (ERROR_ALREADY_INITIALIZED)
憑證要求對象已經初始化。

備註

InitializeFromTemplate 方法會建立下列集合：

方法接著會檢查範本，並執行下列動作：

  • 將範本指定的延伸模組新增至 IX509Extensions 集合。
  • 如果範本指出這些擴充功能不是重要的，則從集合中移除默認關鍵延伸模組 (XCN_OID_KEY_USAGE 和XCN_OID_BASIC_CONSTRAINTS2) 。 範本標示為重大的 OID 會新增。
  • 如果範本支援對稱演算法，請設定 SmimeCapabilities 屬性。
  • 如果範本需要離散簽章演算法 OID，請設定 AlternateSignatureAlgorithm 屬性。
  • 建立 IX509SignatureInformation 物件。
  • 如果在範本中指定演算法，並在 IX509SignatureInformation 對象上設定該演算法，則會建立哈希演算法 OID。
  • 如果在範本中指定演算法，並在 IX509SignatureInformation 對象上設定該演算法，則會建立非對稱加密演算法 OID。
  • 從範本設定填入許多 IX509PrivateKey 屬性。

如果 CSPInformations 屬性為 NULL，此方法會從電腦上安裝的提供者建立 ICspInformations 集合。

規格需求

需求 值
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限桌面應用程式]
目標平台 Windows
標頭 certenroll.h

另請參閱

IX509CertificateRequestPkcs10V2