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

Статья
03/14/2023

Метод 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

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