IEnumCERTVIEWEXTENSION::Next-Methode (certview.h)

Artikel
08/22/2023

Die Next-Methode wechselt zur nächsten Erweiterung in der Erweiterungsenumerationssequenz.

Syntax

HRESULT Next(
  [out] LONG *pIndex
);

Parameter

[out] pIndex

Ein Zeiger auf eine Variable, die den Indexwert der nächsten Erweiterung enthält, auf die verwiesen wird. Wenn keine weiteren Erweiterungen zum Aufzählen vorhanden sind, wird diese Variable auf –1 festgelegt. Diese Methode schlägt fehl, wenn pIndexNULL ist.

Rückgabewert

C++

Wenn die Methode erfolgreich ist, gibt die Methode S_OK zurück, und auf die nächste Erweiterung wird nun verwiesen. Wenn keine Erweiterungen mehr vorhanden sind, wird S_FALSE zurückgegeben, und der pIndex-Parameter wird auf den Wert –1 festgelegt.

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.

VB

Der Rückgabewert ist der Indexwert der Erweiterung, auf die jetzt von der Erweiterungsenumerationssequenz verwiesen wird. Wenn keine weiteren Erweiterungen aufgelistet werden müssen, ist der Rückgabewert –1.

Hinweise

Nach erfolgreichem Abschluss dieser Methode kann über die folgenden Methoden auf den Erweiterungsnamen, die Flags und den Wert zugegriffen werden:

Beispiele

LONG  Index;
LONG  nCount;

// determine the number of extensions
nCount = 0;
// pEnumExt is previously instantiated IEnumCERTVIEWEXTENSION object
while (S_OK == pEnumExt->Next(&Index))
{
    nCount++;
}
printf("Number of extensions is %d\n", nCount);

Anforderungen


Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certview.h (include Certsrv.h)
Bibliothek	Certidl.lib
DLL	Certadm.dll