IX509CertificateRequestPkcs10：：InitializeFromTemplateName 方法 (certenroll.h)

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

語法

HRESULT InitializeFromTemplateName(
  [in] X509CertificateEnrollmentContext Context,
  [in] BSTR                             strTemplateName
);

[in] Context

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

[in] strTemplateName

BSTR 變數，其中包含範本出現在 Active Directory 或虛線十進位物件識別碼中的一般名稱 (CN) 。

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

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

傳回碼/值	Description
HRESULT_FROM_WIN32 (ERROR_ALREADY_INITIALIZED)	憑證要求對象已經初始化。

InitializeFromTemplateName 方法會建立下列集合：

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

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

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