Método ICertRequest2::GetFullResponseProperty (certcli.h)

  • Artículo

El método GetFullResponseProperty recupera los datos de respuesta almacenados en caché devueltos por el servidor.

Sintaxis

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

Parámetros

[in] PropId

Datos que se van a recuperar. Si la propiedad está indizada, use PropIndex para especificar el índice. Este parámetro puede ser uno de los valores siguientes.

Valor Significado
FR_PROP_NONE
0
 No hay datos.
FR_PROP_FULLRESPONSE
1
 Se recuperan todos los datos almacenados en caché (datos binarios).
FR_PROP_STATUSINFOCOUNT
2
 Número de respuestas en datos de caché (propiedad indizada larga).
FR_PROP_BODYPARTSTRING
3
 Datos de jerarquía (cadena, propiedad indizada).
FR_PROP_STATUS
4
 Valor de estado de la solicitud (propiedad long, indizada).
FR_PROP_STATUSSTRING
5
 Cadena de estado de la solicitud (cadena, propiedad indizada).
FR_PROP_OTHERINFOCHOICE
6
 Opción para otra información (propiedad indizada larga). Puede ser uno de los valores siguientes.
  • CMC_OTHER_INFO_NO_CHOICE
  • CMC_OTHER_INFO_FAIL_CHOICE
  • CMC_OTHER_INFO_PEND_CHOICE
FR_PROP_FAILINFO
7
 Información de error de solicitud (propiedad indizada larga).
FR_PROP_PENDINFOTOKEN
8
 Token pendiente de solicitud (propiedad binaria, indizada).
FR_PROP_PENDINFOTIME
9
 Fecha pendiente de solicitud (DATE, propiedad indizada).
FR_PROP_ISSUEDCERTIFICATEHASH
10
 El hash del certificado emitido se recupera (propiedad binaria, indizada).
FR_PROP_ISSUEDCERTIFICATE
11
 El certificado emitido se recupera (propiedad binaria, indizada).
FR_PROP_ISSUEDCERTIFICATECHAIN
12
 Certificado emitido (propiedad binaria, indizada).
FR_PROP_ISSUEDCERTIFICATECRLCHAIN
13
 Cadena de certificados emitida (propiedad binaria e indizada).
FR_PROP_ENCRYPTEDKEYHASH
14
 Hash de clave cifrada (propiedad binaria e indizada).
FR_PROP_FULLRESPONSENOPKCS7
15
 Todos los datos almacenados en caché se recuperan excepto el PKCS #7 (binario).
FR_PROP_CAEXCHANGECERTIFICATEHASH
16
 Hash del certificado de intercambio de ca.
FR_PROP_CAEXCHANGECERTIFICATE
17
 El certificado de intercambio de ca.
FR_PROP_CAEXCHANGECERTIFICATECHAIN
18
 La cadena de certificados de intercambio de ca.
FR_PROP_CAEXCHANGECERTIFICATECRLCHAIN
19
 Cadena CLR del certificado de intercambio de entidades de certificación.
FR_PROP_ATTESTATIONCHALLENGE
20
 Respuesta de desafío de atestación de clave
FR_PROP_ATTESTATIONPROVIDERNAME
21
 Nombre del proveedor de almacenamiento de claves para la atestación de claves.

[in] PropIndex

Índice de base cero cuando PropId es una propiedad indizada. Si PropId no es una propiedad indizada, PropIndex debe ser cero.

[in] PropType

Tipo de datos devueltos en pvarPropertyValue. El tipo de propiedad aquí debe coincidir con el tipo de datos especificado por el parámetro PropId .

Este parámetro puede ser uno de los valores siguientes.

Valor Significado
PROPTYPE_LONG
1
 Datos largos firmados.
PROPTYPE_DATE
2
 Datos de fecha (incluye fecha y hora).
PROPTYPE_BINARY
3
 Datos binarios.
PROPTYPE_STRING
4
 Datos de cadena.

[in] Flags

Formato de los datos devueltos en pvarPropertyValue. La marca establecida aquí debe coincidir con el tipo de datos especificado por el parámetro PropId .

Para obtener más información, vea la sección Comentarios. Este parámetro puede ser uno de los valores siguientes.

Valor Significado
CR_OUT_BASE64HEADER
0
 Formato BASE64 con encabezado begin/end.
CR_OUT_BASE64
1
 Formato BASE64 sin encabezado begin/end.
CR_OUT_BINARY
2
 Formato binario.

[out] pvarPropertyValue

Datos devueltos.

Valor devuelto

C++

Si el método se ejecuta correctamente, el método devuelve S_OK y pvarPropertyValue contiene los datos devueltos.

Si se produce un error en el método, devuelve un valor HRESULT que indica el error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

VB

El valor devuelto es un valor Variant que contiene los datos devueltos.

Comentarios

Los siguientes valores de PropId devuelven datos binarios, lo que significa que el parámetro Flags debe establecerse en CR_OUT_BINARY:

  • FR_PROP_FULLRESPONSE
  • FR_PROP_ISSUEDCERTIFICATEHASH
  • FR_PROP_ISSUEDCERTIFICATE
  • FR_PROP_ISSUEDCERTIFICATECHAIN
  • FR_PROP_ISSUEDCERTIFICATECRLCHAIN
  • FR_PROP_ENCRYPTEDKYEHASH
  • FR_PROP_FULLRESPONSENOPKCS7
Se llama a este método después de llamar a los métodos ICertRequest3::Submit o ICertRequest3::RetrievePending . Estos métodos rellenan los datos almacenados en caché devueltos por GetFullResponseProperty.

Después de que el método ICertRequest3::GetFullResponseProperty devuelva sus datos, se puede llamar a los métodos siguientes:

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado certcli.h (incluya Certsrv.h)
Library Certidl.lib
Archivo DLL Certcli.dll