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


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