IEnumCERTVIEWATTRIBUTE::Skip-Methode (certview.h)

Artikel
02/26/2024

Die Skip-Methode überspringt eine angegebene Anzahl von Attributen in der Attributenumerationssequenz.

Syntax

HRESULT Skip(
  [in] LONG celt
);

Parameter

[in] celt

Die Anzahl der zu überspringenden Attribute. Ein positiver Wert für den celt-Parameter bewirkt, dass die Sequenz der Attributenumeration in der Sequenz übersprungen wird. Ein negativer Wert für den celt-Parameter bewirkt, dass die Sequenz der Attributenumeration 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 Attributenumerationssequenz 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 IEnumCERTVIEWATTRIBUTE::Next-Methode auf, um auf das aktuelle Attribut in der Attributenumerationssequenz zu verweisen. Auf den Attributnamen und -wert kann über die folgenden Methoden zugegriffen werden:

Die Sequenz der Attributenumeration verwaltet einen internen nullbasierten Index. Der Aufruf der Skip-Methode bewirkt, dass dieser Index um die Anzahl von Attributen erhöht oder verringert wird, die im celt-Parameter angegeben sind.

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

Wenn ein positiver Wert des celt-Parameters dazu führt, dass der Index das letzte Attribut in der Enumerationssequenz überschreitet, schlägt ein nachfolgender Aufruf der IEnumCERTVIEWATTRIBUTE::Next-Methode fehl.

Beispiele

HRESULT  hr;
LONG     Index;

// pEnumAttr is previously instantiated IEnumCERTVIEWATTRIBUTE object
// skip the next 5 attributes
hr = pEnumAttr->Skip(5);
if (S_OK == hr)
{
    // get the next attribute
    hr = pEnumAttr->Next(&Index);
    if (S_OK == hr)
    {
        // Use this attribute 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

Weitere Informationen

IEnumCERTVIEWATTRIBUTE

IEnumCERTVIEWATTRIBUTE::Reset

IEnumCERTVIEWATTRIBUTE:Next

Freigeben über