ICertificateEnrollmentServerSetup：：InitializeInstallDefaults 方法 (casetup.h)

  • 项目

InitializeInstallDefaults 方法使用默认配置初始化 ICertificateEnrollmentServerSetup 对象。

语法

HRESULT InitializeInstallDefaults();

返回值

返回代码 说明
E_ACCESSDENIED
 用户必须是域根或企业的管理员。 计算机必须加入域。

如果用户不是域根管理员或企业管理员，则 ErrorString 属性设置为：

“你必须是企业管理员组的成员才能运行安装程序。”

如果计算机未加入域，则 ErrorString 属性设置为：

“证书注册 Web 服务或证书注册策略 Web 服务不能安装在不是域成员的计算机上。”
HRESULT_FROM_WIN32 (ERROR_INVALID_STATE)
ICertificateEnrollmentServerSetup 对象已初始化。 ErrorString 属性设置为：

“安装程序对象已初始化。 此对象不能多次初始化。”

注解

此方法执行以下操作：

  • 确定 ICertificateEnrollmentServerSetup 对象是否已初始化。
    注意如果此检查失败，该方法会将 ErrorString 属性设置为“安装程序对象已初始化。 此对象不能多次初始化。”
     
  • 确定用户是域根管理员还是企业管理员。
    注意如果此检查失败，该方法会将 ErrorString 属性设置为“你必须是企业管理员组的成员才能运行安装程序。
     
  • 确定计算机是否已加入域。
    注意如果此检查失败，该方法会将 ErrorString 属性设置为“证书注册 Web 服务或证书注册策略 Web 服务不能安装在不是域成员的计算机上。
     
  • 将默认身份验证过程设置为 Kerberos。 可以调用 SetProperty 来更改身份验证方法。
  • 确定是否在运行 Windows Server 2008 R2 的计算机上安装 CES。
    注意如果此检查失败，该方法会将 ErrorString 属性设置为“证书注册 Web 服务或证书注册策略 Web 服务必须安装在已成功运行 Windows Server 2008 R2 版本的 ADPrep /forestprep 的 Active Directory 林的成员服务器上。
     
  • 将默认服务器上下文设置为 ApplicationPoolIdentity 内置帐户。
  • 将 ENUM_CESSETUPPROP_RENEWALONLY 属性设置为 FALSE。
  • 如果存在有效的证书颁发机构 (CA) 配置，则ENUM_CESSETUPPROP_URL属性设置为“https:// computerDNSname/SanitizedCAShortName_CES_Kerberos/service.svc/ces”。 如果不存在有效的配置，则不会设置 ENUM_CESSETUPPROP_URL 属性。 SanitizedCAShortName 是 CA 的净化短名称。 有关清理后的名称的详细信息，请参阅 GetConfig。
    注意 如果证书颁发机构是独立 CA，则 ErrorString 属性设置为“证书注册 Web 服务不能与独立证书颁发机构一起使用 (CA) 。 它只能与企业 CA 一起使用。”
     
在调用除 UnInstall 之外的任何方法之前，必须调用 InitializeInstallDefaults 方法。 调用 Install 方法以安装配置的服务。 在新的 ICertificateEnrollmentServerSetup 对象上调用 UnInstall 以删除该服务。

要求

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

另请参阅

CESSetupProperty

ICertificateEnrollmentServerSetup