共用方式為

IX509EnrollmentHelper：：Enroll 方法 (certenroll.h)

  • 發行項

Enroll 方法會註冊憑證要求，並擷取發行的憑證。 此方法已啟用 Web。

語法

HRESULT Enroll(
  [in]          BSTR               strEnrollmentPolicyServerURI,
  [in]          BSTR               strTemplateName,
  [in]          EncodingType       Encoding,
  [in]          WebEnrollmentFlags enrollFlags,
  [out, retval] BSTR               *pstrCertificate
);

參數

[in] strEnrollmentPolicyServerURI

包含憑證註冊原則伺服器 URL 的 BSTR 。

[in] strTemplateName

BSTR 變數，其中包含範本的一般名稱 (CN) ，如 Active Directory 或虛線小數點物件標識碼所示。

[in] Encoding

EncodingType 列舉值，指定套用至位元組陣列的編碼類型以供顯示之用。

[in] enrollFlags

指定 Web 註冊行為的 WebEnrollmentFlags 列舉值。 這可以是下列值。

值 意義
EnrollPrompt
 如果已設定此旗標，且憑證註冊伺服器沒有可用的驗證認證，則憑證服務會提示輸入認證。 如果沒有驗證認證且未設定此旗標， 則 Enroll 方法會失敗。

[out, retval] pstrCertificate

包含已發行憑證的 BSTR 。

傳回值

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

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

傳回碼 Description
E_INVALIDARG
 strEnrollmentPolicyServerURI 和 strTemplateName 参數不能是 NULL。
HRESULT_FROM_WIN32 (ERROR_ARITHMETIC_OVERFLOW)
strEnrollmentPolicyServerURI 和 strTemplateName 參數超過 64,000 個字元，或包含內嵌的 Null 字元。

備註

Enroll 方法會擷取適當的範本、呼叫 InitializeFromTemplate，然後在 IX509Enrollment 物件上呼叫 Enroll。

這個方法未安裝發行的憑證。

規格需求

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

另請參閱

IX509EnrollmentHelper