IX509Enrollment2：：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 方法：

  • 檢查範本以判斷所需的要求類型。
  • 建立適當的要求物件類型， (PKCS #10、PKCS #7 或 CMC) 。
  • 如果值目前存在，在要求上設定下列屬性：
  • 使用範本初始化要求物件。
  • 從範本擷取簽章計數、發行原則和應用程式原則。

規格需求

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

另請參閱

IX509Enrollment2