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

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

  • Статья

Метод GetFullResponseProperty извлекает кэшированные данные ответа, возвращаемые сервером.

Синтаксис

HRESULT GetFullResponseProperty(
  [in]  LONG    PropId,
  [in]  LONG    PropIndex,
  [in]  LONG    PropType,
  [in]  LONG    Flags,
  [out] VARIANT *pvarPropertyValue
);

Параметры

[in] PropId

Данные, которые требуется извлечь. Если свойство индексируется, используйте PropIndex , чтобы указать индекс. Этот параметр может принимать одно из указанных ниже значений.

Значение Значение
FR_PROP_NONE
0
 Нет данных.
FR_PROP_FULLRESPONSE
1
 Извлекаются все кэшированные данные (двоичные данные).
FR_PROP_STATUSINFOCOUNT
2
 Количество ответов в данных кэша (свойство long, индексированные).
FR_PROP_BODYPARTSTRING
3
 Данные иерархии (строка, индексированные свойства).
FR_PROP_STATUS
4
 Значение состояния запроса (длинное, индексное свойство).
FR_PROP_STATUSSTRING
5
 Строка состояния запроса (строка, индексированные свойства).
FR_PROP_OTHERINFOCHOICE
6
 Выбор других сведений (длинное, индексное свойство). Это может быть одно из следующих значений.
  • CMC_OTHER_INFO_NO_CHOICE
  • CMC_OTHER_INFO_FAIL_CHOICE
  • CMC_OTHER_INFO_PEND_CHOICE
FR_PROP_FAILINFO
7
 Сведения о сбое запроса (свойство long, индексированные).
FR_PROP_PENDINFOTOKEN
8
 Токен ожидания запроса (двоичный файл, индексированные свойства).
FR_PROP_PENDINFOTIME
9
 Дата ожидания запроса (DATE, индексированные свойства).
FR_PROP_ISSUEDCERTIFICATEHASH
10
 Извлекается хэш выданного сертификата (двоичный файл, индексированное свойство).
FR_PROP_ISSUEDCERTIFICATE
11
 Извлекается выданный сертификат (двоичный файл, индексированное свойство).
FR_PROP_ISSUEDCERTIFICATECHAIN
12
 Выданный сертификат (двоичное, индексное свойство).
FR_PROP_ISSUEDCERTIFICATECRLCHAIN
13
 Цепочка выданных сертификатов (двоичное, индексное свойство).
FR_PROP_ENCRYPTEDKEYHASH
14
 Хэш зашифрованного ключа (двоичный файл, индексированные свойства).
FR_PROP_FULLRESPONSENOPKCS7
15
 Извлекаются все кэшированные данные, за исключением PKCS 7 (двоичный файл).
FR_PROP_CAEXCHANGECERTIFICATEHASH
16
 Хэш сертификата ЦС exchange.
FR_PROP_CAEXCHANGECERTIFICATE
17
 Сертификат ЦС exchange.
FR_PROP_CAEXCHANGECERTIFICATECHAIN
18
 Цепочка сертификатов обмена ЦС.
FR_PROP_CAEXCHANGECERTIFICATECRLCHAIN
19
 Цепочка CLR сертификатов ЦС exchange.
FR_PROP_ATTESTATIONCHALLENGE
20
 Ответ на запрос на аттестацию ключей
FR_PROP_ATTESTATIONPROVIDERNAME
21
 Имя поставщика хранилища ключей для аттестации ключей.

[in] PropIndex

Отсчитываемый от нуля индекс, если PropId является индексным свойством. Если PropId не является индексированным свойством, то значение PropIndex должно быть равно нулю.

[in] PropType

Тип данных, возвращаемых в pvarPropertyValue. Тип свойства здесь должен соответствовать типу данных, заданному параметром PropId .

Этот параметр может принимать одно из указанных ниже значений.

Значение Значение
PROPTYPE_LONG
1
 Подписанные длинные данные.
PROPTYPE_DATE
2
 Данные даты (включая дату и время).
PROPTYPE_BINARY
3
 Двоичные данные.
PROPTYPE_STRING
4
 Строковые данные.

[in] Flags

Формат данных, возвращаемых в pvarPropertyValue. Флаг, заданный здесь, должен соответствовать типу данных, заданному параметром PropId .

Дополнительные сведения см. в подразделе "Примечания". Этот параметр может принимать одно из указанных ниже значений.

Значение Значение
CR_OUT_BASE64HEADER
0
 Формат BASE64 с начальным и конечным заголовком.
CR_OUT_BASE64
1
 Формат BASE64 без начального и конечного заголовка.
CR_OUT_BINARY
2
 Двоичный формат.

[out] pvarPropertyValue

Возвращаемые данные.

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

C++

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

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

VB

Возвращаемое значение — это значение Типа Variant , содержащее возвращаемые данные.

Комментарии

Следующие значения PropId возвращают двоичные данные, что означает, что параметру Flags необходимо задать значение CR_OUT_BINARY:

  • FR_PROP_FULLRESPONSE
  • FR_PROP_ISSUEDCERTIFICATEHASH
  • FR_PROP_ISSUEDCERTIFICATE
  • FR_PROP_ISSUEDCERTIFICATECHAIN
  • FR_PROP_ISSUEDCERTIFICATECRLCHAIN
  • FR_PROP_ENCRYPTEDKYEHASH
  • FR_PROP_FULLRESPONSENOPKCS7
Этот метод вызывается после вызова методов ICertRequest3::Submit или ICertRequest3::RetrievePending . Эти методы заполняют кэшированные данные, возвращаемые getFullResponseProperty.

После того как метод ICertRequest3::GetFullResponseProperty возвращает свои данные, можно вызвать следующие методы:

Требования

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