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

Статья
07/16/2024

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

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