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

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

  • Статья

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

Синтаксис

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

Параметры

[in] propertyId

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

[out] pPropertyValue

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

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

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

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

Комментарии

Тип перечисления CESSetupProperty содержит следующие значения:

  • ENUM_CESSETUPPROP_USE_IISAPPPOOLIDENTITY
  • ENUM_CESSETUPPROP_CACONFIG
  • ENUM_CESSETUPPROP_AUTHENTICATION
  • ENUM_CESSETUPPROP_SSLCERTHASH
  • ENUM_CESSETUPPROP_URL
  • ENUM_CESSETUPPROP_RENEWALONLY

Данные величины имеют следующие значения:

  • Свойство ENUM_CESSETUPPROP_USE_IISAPPPOOLIDENTITY — это VT_BOOL значение, указывающее, является ли контекст сервера ApplicationPoolIdentity.
  • Свойство ENUM_CESSETUPPROP_CACONFIG содержит строку конфигурации центра сертификации (ЦС) (VT_BSTR) в форме имя_компьютераDNSname/CAName , где computerDNSname — полное DNS-имя сервера, а CAName — общее имя ЦС.
  • Свойство ENUM_CESSETUPPROP_AUTHENTICATION указывает тип используемой процедуры проверки подлинности. Если метод GetProperty возвращает успешно, аргумент pPropertyValue будет содержать одну из следующих констант:
    • X509AuthKerberos
    • X509AuthUsername
    • X509AuthCertificate
  • Свойство ENUM_CESSETUPPROP_SSLCERTHASH содержит хэш (VT_BSTR) сертификата, используемого во время проверки подлинности. Свойство ENUM_CESSETUPPROP_AUTHENTICATION должно иметь значение X509AuthCertificate.
  • Свойство ENUM_CESSETUPPROP_URL содержит URL-адрес службы CES. Если метод GetProperty возвращает успешно, аргумент pPropertyValue будет содержать подтип VT_BSTR , содержащий URL-адрес в формате "https:// computerDNSname/ADPolicyProvider_ces_AuthenticationType/service.svc/ces", где тип проверки подлинности может быть одним из следующих:
    • Kerberos
    • usernamepassword
    • сертификат
  • Свойство ENUM_CESSETUPPROP_RENEWALONLY — это значение VT_BOOL , указывающее, может ли CES обрабатывать только продление сертификата.

Требования

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

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

ICertificateEnrollmentServerSetup