IEnumCERTVIEWEXTENSION::Skip-Methode (certview.h)

Artikel
08/22/2023

Die Skip-Methode überspringt eine angegebene Anzahl von Erweiterungen in der Erweiterungsenumerationssequenz.

Syntax

HRESULT Skip(
  [in] LONG celt
);

Parameter

[in] celt

Die Anzahl der zu überspringenden Erweiterungen. Ein positiver Wert für den celt-Parameter bewirkt, dass die Erweiterungsenumerationssequenz in der Sequenz übersprungen wird. Ein negativer Wert für den celt-Parameter bewirkt, dass die Sequenz der Erweiterungsenumeration in der Sequenz 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 ein negativer Wert für den celt-Parameter dazu geführt hat, dass der Index der Erweiterungsenumerationssequenz 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 IEnumCERTVIEWEXTENSION::Next-Methode auf, um auf die aktuelle Erweiterung in der Erweiterungsenumerationssequenz zu verweisen. Auf den Namen, die Flags und den Wert der Erweiterung kann über die folgenden Methoden zugegriffen werden:

Die Erweiterungsenumerationssequenz verwaltet einen internen nullbasierten Index. Der Aufruf der Skip-Methode bewirkt, dass dieser Index um die Im celt-Parameter angegebene Anzahl von Erweiterungen 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 IEnumCERTVIEWEXTENSION::Next nicht definiert.

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

Beispiele

HRESULT  hr;
LONG     Index;

// pEnumExt is previously instantiated IEnumCERTVIEWEXTENSION object
// skip the next 5 extensions
hr = pEnumExt->Skip(5);
if (S_OK == hr)
{
    // get the next extension
    hr = pEnumExt->Next(&Index);
    if (S_OK == hr)
    {
        // Use this extension as needed.
    }
}

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