Metodo ICertRequest2::GetFullResponseProperty (certcli.h)

  • Articolo

Il metodo GetFullResponseProperty recupera i dati di risposta memorizzati nella cache restituiti dal server.

Sintassi

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

Parametri

[in] PropId

Dati da recuperare. Se la proprietà è indicizzata, utilizzare PropIndex per specificare l'indice. Questo parametro può avere uno dei valori seguenti.

Valore Significato
FR_PROP_NONE
0
 Nessun dato.
FR_PROP_FULLRESPONSE
1
 Tutti i dati memorizzati nella cache vengono recuperati (dati binari).
FR_PROP_STATUSINFOCOUNT
2
 Numero di risposte nei dati della cache (proprietà estesa e indicizzata).
FR_PROP_BODYPARTSTRING
3
 Dati della gerarchia (stringa, proprietà indicizzata).
FR_PROP_STATUS
4
 Valore dello stato della richiesta (proprietà estesa, indicizzata).
FR_PROP_STATUSSTRING
5
 Stringa di stato della richiesta (stringa, proprietà indicizzata).
FR_PROP_OTHERINFOCHOICE
6
 Scelta per altre informazioni (proprietà estesa, indicizzata). Può trattarsi di uno dei valori seguenti.
  • CMC_OTHER_INFO_NO_CHOICE
  • CMC_OTHER_INFO_FAIL_CHOICE
  • CMC_OTHER_INFO_PEND_CHOICE
FR_PROP_FAILINFO
7
 Informazioni sull'errore della richiesta (proprietà estesa, indicizzata).
FR_PROP_PENDINFOTOKEN
8
 Token di richiesta in sospeso (proprietà binaria, indicizzata).
FR_PROP_PENDINFOTIME
9
 Data in sospeso della richiesta (DATE, proprietà indicizzata).
FR_PROP_ISSUEDCERTIFICATEHASH
10
 L'hash del certificato emesso viene recuperato (proprietà binaria, indicizzata).
FR_PROP_ISSUEDCERTIFICATE
11
 Il certificato emesso viene recuperato (proprietà binaria, indicizzata).
FR_PROP_ISSUEDCERTIFICATECHAIN
12
 Certificato emesso (proprietà binaria, indicizzata).
FR_PROP_ISSUEDCERTIFICATECRLCHAIN
13
 Catena di certificati rilasciata (proprietà binaria, indicizzata).
FR_PROP_ENCRYPTEDKEYHASH
14
 Hash della chiave crittografata (proprietà binaria, indicizzata).
FR_PROP_FULLRESPONSENOPKCS7
15
 Tutti i dati memorizzati nella cache vengono recuperati, ad eccezione del file PKCS #7 (binario).
FR_PROP_CAEXCHANGECERTIFICATEHASH
16
 Hash del certificato di scambio CA.
FR_PROP_CAEXCHANGECERTIFICATE
17
 Certificato di scambio DELLA CA.
FR_PROP_CAEXCHANGECERTIFICATECHAIN
18
 Catena di certificati di scambio CA.
FR_PROP_CAEXCHANGECERTIFICATECRLCHAIN
19
 Catena CLR del certificato di scambio CA.
FR_PROP_ATTESTATIONCHALLENGE
20
 Risposta alla richiesta di attestazione chiave
FR_PROP_ATTESTATIONPROVIDERNAME
21
 Nome del provider di archiviazione delle chiavi per l'attestazione della chiave.

[in] PropIndex

Indice in base zero quando PropId è una proprietà indicizzata. Se PropId non è una proprietà indicizzata, PropIndex deve essere zero.

[in] PropType

Tipo di dati restituiti in pvarPropertyValue. Il tipo di proprietà deve corrispondere al tipo di dati specificato dal parametro PropId .

Questo parametro può avere uno dei valori seguenti.

Valore Significato
PROPTYPE_LONG
1
 Dati lunghi firmati.
PROPTYPE_DATE
2
 Dati di data (include data e ora).
PROPTYPE_BINARY
3
 Dati binari.
PROPTYPE_STRING
4
 Dati stringa.

[in] Flags

Formato dei dati restituiti in pvarPropertyValue. Il flag impostato qui deve corrispondere al tipo di dati specificato dal parametro PropId .

Per altre informazioni, vedere la sezione Osservazioni. Questo parametro può avere uno dei valori seguenti.

Valore Significato
CR_OUT_BASE64HEADER
0
 Formato BASE64 con intestazione begin/end.
CR_OUT_BASE64
1
 Formato BASE64 senza intestazione di inizio/fine.
CR_OUT_BINARY
2
 Formato binario.

[out] pvarPropertyValue

Dati restituiti.

Valore restituito

C++

Se il metodo ha esito positivo, il metodo restituisce S_OK e pvarPropertyValue contiene i dati restituiti.

Se il metodo ha esito negativo, restituisce un valore HRESULT che indica l'errore. Per un elenco dei codici di errore comuni, vedere Valori HRESULT comuni.

VB

Il valore restituito è un valore Variant che contiene i dati restituiti.

Commenti

I valori PropId seguenti restituiscono dati binari, il che significa che il parametro Flags deve essere impostato su CR_OUT_BINARY:

  • FR_PROP_FULLRESPONSE
  • FR_PROP_ISSUEDCERTIFICATEHASH
  • FR_PROP_ISSUEDCERTIFICATE
  • FR_PROP_ISSUEDCERTIFICATECHAIN
  • FR_PROP_ISSUEDCERTIFICATECRLCHAIN
  • FR_PROP_ENCRYPTEDKYEHASH
  • FR_PROP_FULLRESPONSENOPKCS7
Questo metodo viene chiamato dopo la chiamata dei metodi ICertRequest3::Submit o ICertRequest3::RetrievePending . Questi metodi popolano i dati memorizzati nella cache restituiti da GetFullResponseProperty.

Dopo che il metodo ICertRequest3::GetFullResponseProperty restituisce i dati, è possibile chiamare i metodi seguenti:

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione certcli.h (include Certsrv.h)
Libreria Certidl.lib
DLL Certcli.dll