ICertificateEnrollmentServerSetup::SetProperty 方法 (casetup.h)

SetProperty 方法为证书注册 Web 服务 (CES) 配置指定 CESSetupProperty 枚举值。

语法

HRESULT SetProperty(
  [in] CESSetupProperty propertyId,
  [in] VARIANT          *pPropertyValue
);

参数

[in] propertyId

一个 CESSetupProperty 枚举值,该值指定要检索的属性值。

[in] pPropertyValue

指向包含属性值的 VARIANT 变量的指针。

返回值

返回代码 说明
E_INVALIDARG
propertyId 参数不是 CESSetupProperty 枚举类型的成员。

此外,如果要设置 ENUM_CESSETUPPROP_AUTHENTICATION 属性,则必须在 pPropertyValue 参数中指定以下值之一:

  • X509AuthKerberos
  • X509AuthUsername
  • X509AuthCertificate
E_POINTER
pPropertyValue 参数不能为 NULL
HRESULT_FROM_WIN32 (ERROR_INVALID_STATE)
ICertificateEnrollmentServerSetup 对象尚未初始化。

ErrorString 属性值设置为“尚未初始化安装程序对象。 请使用 InitializeInstallDefaults 方法初始化安装程序对象。”

HRESULT_FROM_WIN32 (ERROR_CLUSTER_PROPERTY_DATA_TYPE_MISMATCH)
如果要设置 ENUM_CESSETUPPROP_AUTHENTICATION 属性,则 VARIANT 子类型必须是 VT_I2VT_I4VT_UI4

注解

在调用 SetProperty 之前,必须调用 InitializeInstallDefaults

不能设置 ENUM_CESSETUPPROP_URL 属性。

如果 WSEnrollmentServer 应用程序池已存在且已初始化 WMI,则无法设置 ENUM_CESSETUPPROP_USE_IISAPPPOOLIDENTITY

如果要设置 ENUM_CESSETUPPROP_AUTHENTICATION 属性, 则 VARIANT 子类型必须是 VT_I2VT_I4VT_UII4并且 pPropertyValue 参数必须是以下常量之一:

  • X509AuthKerberos
  • X509AuthUsername
  • X509AuthCertificate

如果目标服务器是独立的证书颁发机构,则无法设置 ENUM_CESSETUPPROP_CACONFIG 属性。 ErrorString 属性将设置为“证书注册 Web 服务不能与独立证书颁发机构一起使用 (CA) 。 它只能与企业 CA 一起使用。”

.

要求

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

另请参阅

ICertificateEnrollmentServerSetup