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

Article
03/09/2024

[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

Partager via