Metodo ICertRequest2::GetFullResponseProperty (certcli.h)

Articolo
03/05/2024

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:

ICEnroll4::AcceptResponse può essere chiamato per installare il certificato restituito.
ICEnroll4::GetCertFromResponse può essere chiamato per analizzare il certificato dalla risposta.

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

Condividi tramite