ICEnroll4::enumPendingRequest-Methode (xenroll.h)

Artikel
08/28/2023

[Diese Methode ist ab Windows Server 2008 und Windows Vista nicht mehr verfügbar.]

Die enumPendingRequest-Methode listet ausstehende Zertifikatanforderungen auf und ruft jeweils eine angegebene Eigenschaft ab.

Diese Methode wurde zuerst in der ICEnroll4-Schnittstelle definiert.

Syntax

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

Parameter

[in] lIndex

Gibt die Ordnungsposition der ausstehenden Anforderung an, deren Eigenschaft abgerufen wird. Geben Sie null für die erste Anforderung an.

[in] lDesiredProperty

Der Bezeichner für die eigenschaft, die abgerufen wird. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
XEPR_CADNS	Der DNS-Name für die Zertifizierungsstelle (Certification Authority , CA).
XEPR_CAFRIENDLYNAME	Der Anzeigename der Zertifizierungsstelle.
XEPR_CANAME	Der Name der Zertifizierungsstelle.
XEPR_HASH	Der Hashwert der Anforderung.
XEPR_REQUESTID	Die Zertifikatanforderungs-ID.

[out] pvarProperty

Ein Zeiger auf einen VARIANT-Wert , der den Wert der abgerufenen Eigenschaft empfängt.

Wenn Sie die Verwendung von VARIANT abgeschlossen haben, geben Sie sie frei, indem Sie die VariantClear-Funktion aufrufen.

Rückgabewert

C++

Wenn die Methode erfolgreich ist, gibt die Methode S_OK zurück.

Wenn die Methode fehlschlägt, gibt sie einen HRESULT-Wert zurück, der den Fehler angibt. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Wenn die folgenden Werte für lDesiredProperty angegeben werden, gibt diese Methode E_NOTIMPL zurück:

XEPR_DATE
XEPR_V1TEMPLATENAME
XEPR_V2TEMPLATEOID
XEPR_VERSION

Wenn Sie einen anderen Wert für lDesiredProperty angeben, gibt diese Methode E_INVALIDARG zurück.

VB

Gibt einen Variant-Wert zurück, der eine Eigenschaft aus einer ausstehenden Anforderung enthält.

Hinweise

Diese Methode ist deaktiviert, wenn das Zertifikatregistrierungssteuerelement als skriptbasiertes Steuerelement ausgeführt wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	xenroll.h
Bibliothek	Uuid.lib
DLL	Xenroll.dll

Freigeben über