IEnumCERTVIEWEXTENSION::Skip-Methode (certview.h)

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

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:

• IEnumCERTVIEWEXTENSION::GetName
• IEnumCERTVIEWEXTENSION::GetFlags
• IEnumCERTVIEWEXTENSION::GetValue

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

Weitere Informationen

IEnumCERTVIEWEXTENSION

IEnumCERTVIEWEXTENSION::GetFlags

IEnumCERTVIEWEXTENSION::GetName

IEnumCERTVIEWEXTENSION::GetValue

IEnumCERTVIEWEXTENSION::Next