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

  • Article

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 :

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