Метод ICertRequest2::GetCAPropertyDisplayName (certcli.h)

Статья
08/22/2023

Метод GetCAPropertyDisplayName извлекает отображаемое имя свойства для свойства центра сертификации (ЦС).

Синтаксис

HRESULT GetCAPropertyDisplayName(
  [in]          const BSTR strConfig,
  [in]          LONG       PropId,
  [out, retval] BSTR       *pstrDisplayName
);

Параметры

[in] strConfig

Представляет допустимую строку конфигурации для ЦС в формате Имя_\компьютера CAName, где ComputerName — сетевое имя сервера служб сертификации, а CAName — общее имя ЦС, указанное при настройке служб сертификации. Дополнительные сведения об имени строки конфигурации см. в разделе ICertConfig.

[in] PropId

Указывает идентификатор свойства. Сведения об этом параметре см. в таблице в разделе ICertAdmin2::GetCAProperty.

[out, retval] pstrDisplayName

Указатель на BSTR , представляющий отображаемое имя свойства. Завершив использование BSTR, освободите его, вызвав функцию SysFreeString .

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

C++

Если метод завершается успешно, метод возвращает S_OK.

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

VB

Возвращаемое значение — это строка , содержащая отображаемое имя свойства.

Напротив, в реализациях метода ICertRequest2 и ICertRequest3 ЦС по умолчанию не требует никаких прав доступа. Применяются только списки управления доступом (ACL) модели DCOM; Для присоединенного к домену ЦС списки управления доступом DCOM разрешают всем доступ к ЦС. Все пользователи не включают анонимные. Интерфейс запросов ЦС можно заблокировать с помощью конфигурации реестра, чтобы у вызывающего абонента был доступ к регистрации.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	certcli.h (включая Certsrv.h)
Библиотека	Certidl.lib
DLL	Certcli.dll