IEnumCERTVIEWROW::Skip-Methode (certview.h)

Artikel
08/22/2023

Die Skip-Methode überspringt eine angegebene Anzahl von Zeilen in der Zeilenenumerationssequenz.

Syntax

HRESULT Skip(
  [in] LONG celt
);

Parameter

[in] celt

Die Anzahl der zu überspringenden Zeilen. Ein positiver Wert für den celt-Parameter bewirkt, dass die Zeilenenumerationssequenz in der Enumerationssequenz übersprungen wird. Ein negativer Wert für den celt-Parameter bewirkt, dass die Zeilenenumerationssequenz in der Enumerationssequenz rückwärts übersprungen wird.

Rückgabewert

VB

Wenn die Methode erfolgreich ist, gibt die Methode S_OK zurück.

Der Rückgabewert E_INVALIDARG gibt an, dass der celt-Parameter auf eine negative Zahl festgelegt wurde, wodurch der Zeilenenumerationssequenzindex kleiner als 0 (null) wurde.

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::Skip-Methode auf, um auf die aktuelle Zeile in der Zeilenenumerationssequenz 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:

Die Zeilenenumerationssequenz verwaltet einen internen nullbasierten Index. Der Aufruf der Skip-Methode bewirkt, dass dieser Index basierend auf der Einstellung des celt-Parameters erhöht oder verringert wird.

Wenn ein negativer Wert des celt-Parameters dazu führt, dass der Index kleiner als 0 ist, ist das Verhalten der nachfolgenden Aufrufe von Next nicht definiert.

Wenn ein positiver Wert des celt-Parameters bewirkt, dass der Index die letzte Zeile in der Enumerationssequenz überschreitet, schlägt ein nachfolgender Aufruf der Next-Methode fehl.

Beispiele

// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW.
HRESULT  hr;
LONG     Index;
// Reposition the row enumerator to the beginning of the rows.
hr = pEnumRow->Reset();
if (FAILED(hr))
{
    printf("Unable to reset pEnumRow\n");
    goto error;
}
// Skip some rows.
hr = pEnumRow->Skip(5);
if (FAILED(hr))
{
    printf("Unable to skip rows\n");
    goto error;
}

// Get the next row.
hr = pEnumRow->Next(&Index);
if (S_OK == hr)
{
    // Use this row as needed.
}

error:

if (NULL != pEnumRow)
    pEnumRow->Release();

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