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

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

  • Статья

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

Синтаксис

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

Параметры

[in] propertyId

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

Значение Описание
ENUM_CEPSETUPPROP_AUTHENTICATION Параметр pPropertyValue содержит значение, определяющее тип используемой проверки подлинности.
ENUM_CEPSETUPPROP_SSLCERTHASH Параметр pPropertyValue содержит хэш сертификата, если таковой имеется, используемого во время проверки подлинности.
ENUM_CEPSETUPPROP_KEYBASED_RENEWAL Параметр pPropertyValue указывает, следует ли настроить сервер политики регистрации в режиме, который возвращает политики только для шаблонов KeyBasedRenewal.
ENUM_CEPSETUPPROP_URL Содержит URL-адрес службы CEP. Если метод GetProperty возвращает успешно, аргумент pPropertyValue будет содержать подтип VT_BSTR , содержащий URL-адрес формы "https:// computerDNSname/ADPolicyProvider_cep_AuthenticationType/service.svc/cep", где тип проверки подлинности может быть одним из следующих:
  • Kerberos
  • usernamepassword
  • сертификат

[out] pPropertyValue

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

Если указать ENUM_CEPSETUPPROP_AUTHENTICATION в параметре propertyId , параметр pPropertyValue будет содержать одну из следующих констант, если метод GetProperty возвращает успешно:

  • X509AuthKerberos
  • X509AuthUsername
  • X509AuthCertificate

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

Если указать 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 .
E_POINTER
 Параметр pPropertyValue не может иметь значение NULL.
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
 Объект ICertificateEnrollmentPolicyServerSetup не инициализирован.

Свойство ErrorString имеет значение "Объект установки не инициализирован. Инициализируйте объект установки с помощью метода InitializeInstallDefaults".

Требования

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

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

ICertificateEnrollmentPolicyServerSetup

InitializeInstallDefaults

SetProperty