IEnumCERTVIEWROW::Next-Methode (certview.h)
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 |