ICertRequest2 ::GetFullResponseProperty, méthode (certcli.h)

Article
03/14/2023

La méthode GetFullResponseProperty récupère les données de réponse mises en cache retournées par le serveur.

Syntaxe

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

Paramètres

[in] PropId

Données à récupérer. Si la propriété est indexée, utilisez PropIndex pour spécifier l’index. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
FR_PROP_NONE 0	Aucune donnée.
FR_PROP_FULLRESPONSE 1	Toutes les données mises en cache sont récupérées (données binaires).
FR_PROP_STATUSINFOCOUNT 2	Nombre de réponses dans les données de cache (long, propriété indexée).
FR_PROP_BODYPARTSTRING 3	Données de hiérarchie (chaîne, propriété indexée).
FR_PROP_STATUS 4	La requête status valeur (long, propriété indexée).
FR_PROP_STATUSSTRING 5	La requête status chaîne (chaîne, propriété indexée).
FR_PROP_OTHERINFOCHOICE 6	Choix pour d’autres informations (long, propriété indexée). Il peut s’agir de l’une des valeurs suivantes. CMC_OTHER_INFO_NO_CHOICE CMC_OTHER_INFO_FAIL_CHOICE CMC_OTHER_INFO_PEND_CHOICE
FR_PROP_FAILINFO 7	Informations sur l’échec de la demande (propriété longue, indexée).
FR_PROP_PENDINFOTOKEN 8	Jeton de requête en attente (binaire, propriété indexée).
FR_PROP_PENDINFOTIME 9	Date d’attente de la requête (DATE, propriété indexée).
FR_PROP_ISSUEDCERTIFICATEHASH 10	Le hachage du certificat émis est récupéré (binaire, propriété indexée).
FR_PROP_ISSUEDCERTIFICATE 11	Le certificat émis est récupéré (binaire, propriété indexée).
FR_PROP_ISSUEDCERTIFICATECHAIN 12	Certificat émis (binaire, propriété indexée).
FR_PROP_ISSUEDCERTIFICATECRLCHAIN 13	Chaîne de certificats émis (binaire, propriété indexée).
FR_PROP_ENCRYPTEDKEYHASH 14	Hachage de clé chiffré (propriété binaire, indexée).
FR_PROP_FULLRESPONSENOPKCS7 15	Toutes les données mises en cache sont récupérées à l’exception du fichier PKCS #7 (binaire).
FR_PROP_CAEXCHANGECERTIFICATEHASH 16	Hachage du certificat d’échange de l’autorité de certification.
FR_PROP_CAEXCHANGECERTIFICATE 17	Certificat d’échange de l’autorité de certification.
FR_PROP_CAEXCHANGECERTIFICATECHAIN 18	Chaîne de certificats d’échange d’autorité de certification.
FR_PROP_CAEXCHANGECERTIFICATECRLCHAIN 19	Chaîne CLR du certificat d’échange d’autorité de certification.
FR_PROP_ATTESTATIONCHALLENGE 20	Réponse de la demande d’attestation clé
FR_PROP_ATTESTATIONPROVIDERNAME 21	Nom du fournisseur de stockage de clés pour l’attestation de clé.

[in] PropIndex

Index de base zéro lorsque PropId est une propriété indexée. Si PropId n’est pas une propriété indexée, PropIndex doit être égal à zéro.

[in] PropType

Type de données retournées dans pvarPropertyValue. Le type de propriété doit correspondre au type de données spécifié par le paramètre PropId .

Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
PROPTYPE_LONG 1	Données longues signées.
PROPTYPE_DATE 2	Données de date (y compris la date et l’heure).
PROPTYPE_BINARY 3	Données binaires.
PROPTYPE_STRING 4	Données de chaîne.

[in] Flags

Format des données retournées dans pvarPropertyValue. L’indicateur défini ici doit correspondre au type de données spécifié par le paramètre PropId .

Pour plus d'informations, consultez la section Notes. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
CR_OUT_BASE64HEADER 0	Format BASE64 avec en-tête de début/fin.
CR_OUT_BASE64 1	Format BASE64 sans en-tête de début/fin.
CR_OUT_BINARY 2	Format binaire.

[out] pvarPropertyValue

Données retournées.

Valeur retournée

C++

Si la méthode réussit, la méthode retourne S_OK et pvarPropertyValue contient les données retournées.

Si la méthode échoue, elle retourne une valeur HRESULT qui indique l’erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

VB

La valeur de retour est un variant qui contient les données retournées.

Remarques

Les valeurs PropId suivantes retournentdes données binaires , ce qui signifie que le paramètre Flags doit avoir la valeur CR_OUT_BINARY :

FR_PROP_FULLRESPONSE
FR_PROP_ISSUEDCERTIFICATEHASH
FR_PROP_ISSUEDCERTIFICATE
FR_PROP_ISSUEDCERTIFICATECHAIN
FR_PROP_ISSUEDCERTIFICATECRLCHAIN
FR_PROP_ENCRYPTEDKYEHASH
FR_PROP_FULLRESPONSENOPKCS7

Cette méthode est appelée après l’appel des méthodes ICertRequest3 ::Submit ou ICertRequest3 ::RetrievePending . Ces méthodes remplissent les données mises en cache retournées par GetFullResponseProperty.

Une fois que la méthode ICertRequest3 ::GetFullResponseProperty a retourné ses données, les méthodes suivantes peuvent être appelées :

ICEnroll4 ::AcceptResponse peut être appelé pour installer le certificat retourné.
ICEnroll4 ::GetCertFromResponse peut être appelé pour analyser le certificat à partir de la réponse.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	certcli.h (include Certsrv.h)
Bibliothèque	Certidl.lib
DLL	Certcli.dll

Partager via