Compartilhar via


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

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