IEnumCERTVIEWROW::GetMaxIndex-Methode (certview.h)
Die GetMaxIndex-Methode ruft den maximal gültigen Indexwert ab, nachdem auf alle Zeilen in der Zeilenenumerationssequenz verwiesen wurde.
Syntax
HRESULT GetMaxIndex(
[out] LONG *pIndex
);
Parameter
[out] pIndex
Ein Zeiger auf eine LONG-Variable , die den maximalen Indexwert für die Zeilenenumerationssequenz enthält. Diese Methode schlägt fehl, wenn pIndexNULL ist.
Rückgabewert
C++
Wenn die Methode erfolgreich ist, gibt die Methode S_OK zurück, und pIndex wird auf den maximalen Indexwert für die Zeilenenumerationssequenz festgelegt.Wenn der Durchlauf zur letzten Zeile nicht erfolgt ist, schlägt diese Methode mit dem Rückgabewert E_UNEXPECTED fehl.
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 maximale Indexwert für die Zeilenenumerationssequenz. Diese Methode schlägt fehl, wenn der Durchlauf zur letzten Zeile nicht erfolgt ist.Hinweise
Der erfolgreiche Abschluss dieser Methode hängt vom Erreichen der letzten Zeile der Enumerationssequenz ab. Der maximale Zeilenindex kann nützlich sein, um eine Bildlaufleiste oder ein Anzeigefenster zu vergrößern, aber er kann auch ressourcenintensiv für die Berechnung sein, da er eine Auswertung der gesamten Abfrage erfordert. Bei einigen Abfragen müssen die Spaltendaten für jede Zeile untersucht werden, um zu ermitteln, ob sie in der Ansicht enthalten sind. Nachdem der Benutzer alle Daten durchlaufen oder explizit angefordert hat, bis zum Ende fortzufahren, wird der maximale Zeilenindex beibehalten.
Rufen Sie die folgenden Methoden auf, um durch die Zeilenenumerationssequenz zu navigieren.
| Methode | BESCHREIBUNG |
|---|---|
| IEnumCERTVIEWROW::Reset | Wechselt an den Anfang der Enumerationssequenz. |
| IEnumCERTVIEWROW::Next | Wechselt zur nächsten Zeile in der Enumerationssequenz. |
| IEnumCERTVIEWROW::Skip | Überspringt eine angegebene Anzahl von Zeilen. |
Beispiele
#include <windows.h>
#include <stdio.h>
#include <Certview.h>
long nMax;
// Determine the maximum row index.
hr = pRow->GetMaxIndex(&nMax);
if (FAILED(hr))
printf("Failed GetMaxIndex [%x]\n", hr);
else
printf("Max index is: %d\n", nMax);
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 |
Weitere Informationen
IEnumCERTVIEWROW