Partager via

Méthode ICEnroll4 ::enumPendingRequest (xenroll.h)

  • Article

[Cette méthode n’est plus disponible à partir de Windows Server 2008 et Windows Vista.]

La méthode enumPendingRequest énumère les demandes de certificat en attente et récupère une propriété spécifiée de chacune d’elles.

Cette méthode a été définie pour la première fois dans l’interface ICEnroll4 .

Syntaxe

HRESULT enumPendingRequest(
  [in]  LONG    lIndex,
  [in]  LONG    lDesiredProperty,
  [out] VARIANT *pvarProperty
);

Paramètres

[in] lIndex

Spécifie la position ordinale de la requête en attente dont la propriété sera récupérée. Spécifiez zéro pour la première requête.

[in] lDesiredProperty

Identificateur de la propriété récupérée. Ce paramètre peut prendre les valeurs suivantes.

Valeur Signification
XEPR_CADNS
 Nom DNS de l’autorité de certification .
XEPR_CAFRIENDLYNAME
 Nom complet de l’autorité de certification.
XEPR_CANAME
 Nom de l’autorité de certification.
XEPR_HASH
 Valeur de hachage de la requête.
XEPR_REQUESTID
 ID de demande de certificat.

[out] pvarProperty

Pointeur vers un VARIANT qui reçoit la valeur de la propriété récupérée.

Une fois que vous avez terminé d’utiliser le VARIANT, libérez-le en appelant la fonction VariantClear .

Valeur retournée

C++

Si la méthode réussit, la méthode retourne S_OK.

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.

Si les valeurs suivantes sont spécifiées pour lDesiredProperty, cette méthode retourne E_NOTIMPL :

  • XEPR_DATE
  • XEPR_V1TEMPLATENAME
  • XEPR_V2TEMPLATEOID
  • XEPR_VERSION

Si vous spécifiez une autre valeur pour lDesiredProperty , cette méthode retourne E_INVALIDARG.

VB

Retourne un variant qui contient une propriété d’une requête en attente.

Remarques

Cette méthode est désactivée lorsque le contrôle d’inscription de certificat est exécuté en tant que contrôle scripté.

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 xenroll.h
Bibliothèque Uuid.lib
DLL Xenroll.dll