IEnumCERTVIEWROW::Next-Methode (certview.h)

Artikel
02/23/2024

Die Next-Methode wechselt zur nächsten Zeile in der Zeilenenumerationssequenz.

Syntax

HRESULT Next(
  [out] LONG *pIndex
);

Parameter

[out] pIndex

Ein Zeiger auf eine Variable, die den Indexwert der nächsten Zeile enthält, auf die verwiesen wird. Wenn keine weiteren Zeilen aufgelistet werden müssen, 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 Zeile wird nun von der Zeilenenumerationssequenz verwiesen. Wenn keine zeilen mehr aufgelistet werden müssen, wird S_FALSE zurückgegeben, und pIndex 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 Zeile, auf die jetzt von der Zeilenenumerationssequenz verwiesen wird. Wenn keine zeilen mehr aufgelistet werden müssen, ist der Rückgabewert –1.

Hinweise

Nach erfolgreichem Abschluss dieser Methode können die Spalten, Attribute und Erweiterungen, die dem Zertifikat in der Zeile zugeordnet sind, mithilfe der Methoden der folgenden Schnittstellen aufgelistet werden:

Das Durchlaufen aller Zeilen in der Enumerationssequenz kann in Abhängigkeit von der beteiligten Abfrage und der Größe der Sequenz ressourcenintensiv sein.

Beispiele

// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW.
LONG  Index;
LONG  nCount;

// Ensure enumerator is at first row.
if (FAILED(pEnumRow->Reset()))
    printf("Failed to Reset\n");
else
{
    nCount = 0;
    // Count the database records by enumerating the rows.
    while (S_OK == pEnumRow->Next(&Index))
        nCount++;
    // Display number of records.
    printf("Number of records is %d\n", nCount);
}

Anforderungen

Anforderung	Wert
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