Метод ICertRequest2::GetCAPropertyDisplayName (certcli.h)
Метод 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
Возвращаемое значение — это строка , содержащая отображаемое имя свойства.Комментарии
Функциональность метода GetCAPropertyDisplayName аналогична функции метода ICertAdmin2::GetCAPropertyDisplayName .
В методе ICertAdmin2 ЦС требует, чтобы вызывающий объект был доступ на чтение ЦС, который обычно предоставляется только сотрудникам ЦС и администраторам ЦС.
Напротив, в реализациях метода ICertRequest2 и ICertRequest3 ЦС по умолчанию не требует никаких прав доступа. Применяются только списки управления доступом (ACL) модели DCOM; Для присоединенного к домену ЦС списки управления доступом DCOM разрешают всем доступ к ЦС. Все пользователи не включают анонимные. Интерфейс запросов ЦС можно заблокировать с помощью конфигурации реестра, чтобы у вызывающего абонента был доступ к регистрации.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | certcli.h (включая Certsrv.h) |
| Библиотека | Certidl.lib |
| DLL | Certcli.dll |