Поделиться через

Метод ICertificateEnrollmentPolicyServerSetup::SetProperty (casetup.h)

  • Статья

Метод SetProperty задает значение перечисления CEPSetupProperty для конфигурации веб-службы политики регистрации сертификатов (CEP).

Синтаксис

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

Параметры

[in] propertyId

Значение перечисления CEPSetupProperty , указывающее значение свойства для задания. Допустимы следующие значения.

Значение Описание
ENUM_CEPSETUPPROP_AUTHENTICATION Параметр pPropertyValue содержит значение, определяющее тип используемой проверки подлинности.
ENUM_CEPSETUPPROP_SSLCERTHASH Параметр pPropertyValue содержит хэш сертификата, если таковой имеется, используемого во время проверки подлинности. ENUM_CEPSETUPPROP_AUTHENTICATION необходимо задать значение X509AuthCertificate.
ENUM_CEPSETUPPROP_KEYBASED_RENEWAL Параметр pPropertyValue указывает, следует ли настроить сервер политики регистрации в режиме, который возвращает политики только для шаблонов KeyBasedRenewal.
ENUM_CEPSETUPPROP_URL Это значение указать нельзя.

[in] pPropertyValue

Указатель на переменную VARIANT , содержащую значение свойства.

Если указать ENUM_CEPSETUPPROP_AUTHENTICATION в параметре propertyId , подтип VARIANT должен быть VT_I2, VT_I4 или VT_UII4, а аргумент pPropertyValue должен быть одной из следующих констант:

  • X509AuthKerberos
  • X509AuthUsername
  • X509AuthCertificate

При указании ENUM_CEPSETUPPROP_SSLCERTHASH в параметре propertyId необходимо задать для параметра pPropertyValueподтип VT_BSTR , содержащий хэш сертификата, используемого для проверки подлинности.

Если указать ENUM_CEPSETUPPROP_AUTHENTICATION в параметре propertyId , то параметр pPropertyValue содержит процедуру проверки подлинности.

Если указать ENUM_CEPSETUPPROP_URL в параметре propertyId , параметр pPropertyValue содержит URL-адрес веб-службы политики регистрации сертификатов (CEP).

При указании ENUM_CEPSETUPPROP_KEYBASED_RENEWAL в параметре propertyId необходимо задать для параметра pPropertyValueподтип VT_BOOL , указывающий, следует ли настроить сервер политики регистрации в режиме, который возвращает политики только для шаблонов KeyBasedRenewal.

Возвращаемое значение

Код возврата Описание
E_INVALIDARG
 Аргумент propertyId не является членом типа перечисления CEPSetupProperty или вы попытались задать значение ENUM_CEPSETUPPROP_URL .
E_POINTER
 Параметр pPropertyValue не может иметь значение NULL.
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
 Объект ICertificateEnrollmentPolicyServerSetup не инициализирован.

Свойство ErrorString имеет значение "Объект установки не инициализирован. Инициализируйте объект установки с помощью метода InitializeInstallDefaults".
HRESULT_FROM_WIN32(ERROR_CLUSTER_PROPERTY_DATA_TYPE_MISMATCH)
 Если вы задаете свойство ENUM_CEPSETUPPROP_AUTHENTICATION , подтип VARIANT должен быть VT_I2, VT_I4 или VT_UI4.

Комментарии

Перед вызовом метода SetProperty необходимо вызвать InitializeInstallDefaults.

Требования

   
Минимальная версия клиента Windows 7 [только классические приложения]
Минимальная версия сервера Windows Server 2008 R2 [только классические приложения]
Целевая платформа Windows
Header casetup.h
DLL Certocm.dll

См. также раздел

Getproperty

ICertificateEnrollmentPolicyServerSetup

InitializeInstallDefaults