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

Метод ICertAdmin2::SetCAProperty (certadm.h)

Метод SetCAProperty задает значение свойства для центра сертификации (ЦС).

Синтаксис

HRESULT SetCAProperty(
  [in] const BSTR strConfig,
  [in] LONG       PropId,
  [in] LONG       PropIndex,
  [in] LONG       PropType,
  [in] VARIANT    *pvarPropertyValue
);

Параметры

[in] strConfig

Строковое значение, представляющее допустимую строку конфигурации ЦС в форме COMPUTERNAME\CANAME, где ИМЯ_сервера служб сертификатов является сетевым именем сервера служб сертификатов, а CANAME — общее имя ЦС, как указано во время настройки служб сертификатов. Сведения о имени строки конфигурации см. в ICertConfig.

ВажноеSetCAProperty не очищает внутренний кэш при изменении строки конфигурации. При изменении строки конфигурации для ЦС необходимо создать экземпляр нового объекта ICertAdmin и снова вызвать этот метод с новой строкой конфигурации.

 

[in] PropId

Указывает один из следующих идентификаторов свойств.

Сведения обо всех свойствах ЦС, включая доступные только для чтения, см. в ICertAdmin2::GetCAProperty.

Ценность Значение
CR_PROP_KRACERT
 Сертификат агента восстановления ключей ЦС (KRA).

Формат данных: двоичный, индексированные.
CR_PROP_KRACERTCOUNT
 Количество сертификатов KRA для ЦС.

Формат данных: Long.
CR_PROP_KRACERTUSEDCOUNT
 Количество сертификатов KRA, используемых ЦС.

Формат данных: Long.
CR_PROP_ROLESEPARATIONENABLED
 Значение, указывающее, включена ли разделение ролей.

Формат данных: Long.
CR_PROP_TEMPLATES
 Список шаблонов, поддерживаемых ЦС.

Формат данных: строка.

[in] PropIndex

Если параметр PropId индексируется, индекс на основе нуля, используемый при получении значения свойства. Если PropId не индексируется, это значение игнорируется.

[in] PropType

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

Ценность Значение
PROPTYPE_LONG
 Подписанные данные Long.
PROPTYPE_DATE
 Дата и время (зарезервировано для будущего использования).
PROPTYPE_BINARY
 Двоичные данные.
PROPTYPE_STRING
 данныеСтроковых Юникода.

[in] pvarPropertyValue

C++ Указатель на VARIANT, указывающий значение свойства.
VB Параметр Variant, указывающий значение свойства.

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

VB

Если функция выполнена успешно, возвращаемое значение S_OK.

Если функция завершается ошибкой, возвращаемое значение является HRESULT, которая указывает на ошибку. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Не поддерживается
минимальный поддерживаемый сервер Windows Server 2003 [только классические приложения]
целевая платформа Виндоус
заголовка certadm.h (include Certsrv.h)
библиотеки Certidl.lib
DLL Certadm.dll

См. также

ICertAdmin2

ICertAdmin2::GetCAProperty

  • Last updated on