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

  • Artigo

O método GetFullResponseProperty recupera os dados de resposta em cache retornados pelo servidor.

Sintaxe

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

Parâmetros

[in] PropId

Os dados a serem recuperados. Se a propriedade for indexada, use PropIndex para especificar o índice. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
FR_PROP_NONE
0
 Sem dados.
FR_PROP_FULLRESPONSE
1
 Todos os dados armazenados em cache são recuperados (dados binários).
FR_PROP_STATUSINFOCOUNT
2
 O número de respostas em dados de cache (propriedade longa e indexada).
FR_PROP_BODYPARTSTRING
3
 Dados de hierarquia (cadeia de caracteres, propriedade indexada).
FR_PROP_STATUS
4
 A solicitação status valor (propriedade longa e indexada).
FR_PROP_STATUSSTRING
5
 A solicitação status cadeia de caracteres (cadeia de caracteres, propriedade indexada).
FR_PROP_OTHERINFOCHOICE
6
 Escolha para outras informações (propriedade longa e indexada). Esse pode ser um dos valores a seguir.
  • CMC_OTHER_INFO_NO_CHOICE
  • CMC_OTHER_INFO_FAIL_CHOICE
  • CMC_OTHER_INFO_PEND_CHOICE
FR_PROP_FAILINFO
7
 As informações de falha de solicitação (propriedade longa e indexada).
FR_PROP_PENDINFOTOKEN
8
 O token pendente de solicitação (propriedade binária e indexada).
FR_PROP_PENDINFOTIME
9
 A data pendente da solicitação (DATE, propriedade indexada).
FR_PROP_ISSUEDCERTIFICATEHASH
10
 O hash do certificado emitido é recuperado (propriedade binária indexada).
FR_PROP_ISSUEDCERTIFICATE
11
 O certificado emitido é recuperado (propriedade binária e indexada).
FR_PROP_ISSUEDCERTIFICATECHAIN
12
 O certificado emitido (propriedade binária e indexada).
FR_PROP_ISSUEDCERTIFICATECRLCHAIN
13
 A cadeia de certificados emitida (propriedade binária e indexada).
FR_PROP_ENCRYPTEDKEYHASH
14
 O hash de chave criptografada (propriedade binária e indexada).
FR_PROP_FULLRESPONSENOPKCS7
15
 Todos os dados armazenados em cache são recuperados, exceto o PKCS nº 7 (binário).
FR_PROP_CAEXCHANGECERTIFICATEHASH
16
 O hash do certificado de troca de autoridade de certificação.
FR_PROP_CAEXCHANGECERTIFICATE
17
 O certificado de troca de autoridade de certificação.
FR_PROP_CAEXCHANGECERTIFICATECHAIN
18
 A cadeia de certificados de troca de autoridade de certificação.
FR_PROP_CAEXCHANGECERTIFICATECRLCHAIN
19
 A cadeia CLR do certificado de troca de autoridade de certificação.
FR_PROP_ATTESTATIONCHALLENGE
20
 A resposta do desafio de atestado chave
FR_PROP_ATTESTATIONPROVIDERNAME
21
 O nome do provedor de armazenamento de chaves para atestado de chave.

[in] PropIndex

O índice baseado em zero quando PropId é uma propriedade indexada. Se PropId não for uma propriedade indexada, PropIndex deverá ser zero.

[in] PropType

O tipo de dados retornados em pvarPropertyValue. O tipo de propriedade aqui deve corresponder ao tipo de dados especificado pelo parâmetro PropId .

Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
PROPTYPE_LONG
1
 Dados longos assinados.
PROPTYPE_DATE
2
 Dados de data (inclui data e hora).
PROPTYPE_BINARY
3
 Dados binários.
PROPTYPE_STRING
4
 Dados de cadeia de caracteres.

[in] Flags

O formato dos dados retornados em pvarPropertyValue. O sinalizador definido aqui deve corresponder ao tipo de dados especificado pelo parâmetro PropId .

Para obter mais informações, consulte Comentários. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
CR_OUT_BASE64HEADER
0
 Formato BASE64 com cabeçalho de início/fim.
CR_OUT_BASE64
1
 Formato BASE64 sem cabeçalho de início/fim.
CR_OUT_BINARY
2
 Formato binário.

[out] pvarPropertyValue

Os dados retornados.

Retornar valor

C++

Se o método for bem-sucedido, o método retornará S_OK e pvarPropertyValue conterá os dados retornados.

Se o método falhar, ele retornará um valor HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

VB

O valor retornado é um Variant que contém os dados retornados.

Comentários

Os seguintes valores propId retornam dados binários, o que significa que o parâmetro Flags deve definir como CR_OUT_BINARY:

  • FR_PROP_FULLRESPONSE
  • FR_PROP_ISSUEDCERTIFICATEHASH
  • FR_PROP_ISSUEDCERTIFICATE
  • FR_PROP_ISSUEDCERTIFICATECHAIN
  • FR_PROP_ISSUEDCERTIFICATECRLCHAIN
  • FR_PROP_ENCRYPTEDKYEHASH
  • FR_PROP_FULLRESPONSENOPKCS7
Esse método é chamado depois que os métodos ICertRequest3::Submit ou ICertRequest3::RetrievePending foram chamados. Esses métodos preenchem os dados armazenados em cache retornados por GetFullResponseProperty.

Depois que o método ICertRequest3::GetFullResponseProperty retornar seus dados, os seguintes métodos poderão ser chamados:

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho certcli.h (inclua Certsrv.h)
Biblioteca Certidl.lib
DLL Certcli.dll