IX509Enrollment::Enroll 方法 (certenroll.h)

Enroll 方法对请求进行编码,将其提交到相应的证书颁发机构 (CA) ,并安装响应。

语法

HRESULT Enroll();

返回值

如果函数成功,该函数将返回 S_OK

如果函数失败,它将返回指示错误的 HRESULT 值。 可能的值包括(但并不限于)下表中的项。 有关常见错误代码的列表,请参阅 常见 HRESULT 值

返回代码/值 说明
OLE_E_BLANK
注册对象尚未初始化。

注解

如有必要, 方法可能会创建密钥对。 根据初始化注册对象的方式和设置的属性,可能不需要创建密钥对。 例如,如果要使用现有密钥续订证书,或者如果与证书请求关联的 IX509PrivateKey 对象表示现有密钥,则此方法不会创建新的密钥对。

在注册之前,必须通过调用以下方法之一来初始化 IX509Enrollment 对象。

如果注册操作成功,该函数将返回 S_OK。 但是,这并不一定意味着已安装来自 CA 的响应。 调用 Status 属性以确定注册状态。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 certenroll.h
DLL CertEnroll.dll

另请参阅

IX509Enrollment