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

Статья
03/14/2023

Метод GetCAProperty извлекает значение свойства для центра сертификации (ЦС). Функциональные возможности этого метода идентичны функциям ICertAdmin2::GetCAProperty. Сведения об этом методе см. в разделе ICertAdmin2::GetCAProperty.

Синтаксис

HRESULT GetCAProperty(
  [in]          const BSTR strConfig,
  [in]          LONG       PropId,
  [in]          LONG       PropIndex,
  [in]          LONG       PropType,
  [in]          LONG       Flags,
  [out, retval] VARIANT    *pvarPropertyValue
);

Параметры

[in] strConfig

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

[in] PropId

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

[in] PropIndex

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

[in] PropType

Указывает тип свойства, соответствующего столбцу Type в таблице PropId . Тип может быть одним из следующих типов.

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

[in] Flags

Следующие флаги можно использовать для указания формата возвращаемого значения свойства. Эти флаги имеют значение только для двоичных данных (таких как сертификаты, цепочки сертификатов или списки отзыва сертификатов), и в противном случае игнорируются.

Значение	Значение
CV_OUT_BASE64	BASE64 без BEGIN/END
CV_OUT_BASE64HEADER	BASE64 с BEGIN CERTIFICATE и END CERTIFICATE
CV_OUT_BASE64REQUESTHEADER	BASE64 с BEGIN NEW CERTIFICATE REQUEST и END NEW CERTIFICATE REQUEST
CV_OUT_BASE64X509CRLHEADER	BASE64 с BEGIN X509 CRL и END X509 CRL
CV_OUT_BINARY	Двоичные данные
CV_OUT_HEX	Шестнадцатеричная строка
CV_OUT_HEXADDR	Шестнадцатеричная строка с адресом или смещением
CV_OUT_HEXASCII	Шестнадцатеричная строка с ASCII
CV_OUT_HEXASCIIADDR	Шестнадцатеричная строка с ASCII и адресом/смещением

[out, retval] pvarPropertyValue

Указатель на VARIANT , получающий запрошенное значение свойства.

Завершив использование variant, освободите его, вызвав функцию VariantClear .

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

C++

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

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

VB

Возвращаемое значение — это variant , получающий запрошенное значение свойства.

Требования

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

См. также раздел

CCertRequest

ICertRequest

ICertRequest2

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