IEnumCERTVIEWROW::Reset-Methode (certview.h)

Artikel
02/23/2024

Die Reset-Methode wird an den Anfang der Zeilenenumerationssequenz verschoben.

Syntax

HRESULT Reset();

Rückgabewert

VB

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.

Hinweise

Rufen Sie nach erfolgreichem Abschluss dieser Methode die IEnumCERTVIEWROW::Next-Methode auf, um auf die erste Zeile in der Enumeration zu verweisen.

Nach diesem zweiten Aufruf können die Spalten, Attribute und Erweiterungen, die dem Zertifikat in der Zeile zugeordnet sind, mithilfe der Methoden der folgenden Schnittstellen aufgelistet werden:

Beispiele

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

// Ensure enumerator is at first row.
hr = pEnumRow->Reset();
if (FAILED(hr))
    printf("Failed to Reset\n");
else
{
    printf("Reset to beginning\n");
    // Retrieve first record.
    hr = pEnumRow->Next(&Index);
    // Examine hr for success and process row.
    // ...
}

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