Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |