Share via


IX509Enrollment::Enroll 方法 (certenroll.h)

Enroll 方法會編碼要求、將要求提交至適當的證書頒發機構單位 (CA) ,並安裝回應。

Syntax

HRESULT Enroll();

傳回值

如果函式成功,函式會傳回 S_OK

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

傳回碼/值 Description
OLE_E_BLANK
註冊物件尚未初始化。

備註

如有必要,方法可能會建立密鑰組。 根據您初始化註冊物件的方式,以及您設定的屬性而定,可能不需要建立密鑰組。 例如,如果您要使用現有的密鑰來更新憑證,或如果與憑證要求相關聯的 IX509PrivateKey 物件代表現有的密鑰,這個方法就不會建立新的密鑰組。

註冊之前,您必須呼叫下列其中一種方法來初始化 IX509Enrollment 物件。

如果註冊作業成功,函式會傳回 S_OK。 不過,這不一定表示已安裝來自 CA 的回應。 呼叫 Status 屬性以判斷註冊狀態。

規格需求

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

另請參閱

IX509Enrollment