IEnumCERTVIEWCOLUMN::Skip-Methode (certview.h)

Artikel
02/23/2024

Die Skip-Methode überspringt eine angegebene Anzahl von Spalten in der Spaltenenumerationssequenz.

Syntax

HRESULT Skip(
  [in] LONG celt
);

Parameter

[in] celt

Die Anzahl der zu überspringenden Spalten. Ein positiver Wert für den celt-Parameter bewirkt, dass die Spaltenenumerationssequenz in der Enumerationssequenz übersprungen wird. Ein negativer Wert bewirkt, dass die Spaltenenumeration 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 ein negativer Wert im celt-Parameter dazu geführt hat, dass der Index der Spaltenenumerationssequenz 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 Funktion die IEnumCERTVIEWCOLUMN::Next-Methode auf, um auf die aktuelle Spalte in der Spaltenenumerationssequenz zu verweisen. Nachdem dieser zweite Aufruf erfolgt ist, können die Informationen in der Spalte durch Aufrufen einer der folgenden Methoden abgerufen werden:

IEnumCERTVIEWCOLUMN::GetName: Ruft den nicht lokalisierten Namen der Spalte ab.
IEnumCERTVIEWCOLUMN::GetDisplayName: Ruft den lokalisierten Namen der Spalte ab.
IEnumCERTVIEWCOLUMN::GetValue: Ruft die Daten in der Spalte ab.
IEnumCERTVIEWCOLUMN::GetType: Ruft den Datentyp in der Spalte ab.
IEnumCERTVIEWCOLUMN::GetMaxLength: Ruft die maximale Länge der Spalte in Bytes ab.

Die Spaltenenumerationssequenz 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

HRESULT  hr;
LONG     Index;

// pEnumCol is previously instantiated IEnumCERTVIEWCOLUMN object
// skip the next five columns
hr = pEnumCol->Skip(5);
if (S_OK == hr) 
{
    // get the next column
    hr = pEnumCol->Next(&Index);
    if (S_OK == hr)
    {
        // Use this column 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

IEnumCERTVIEWCOLUMN

IEnumCERTVIEWCOLUMN::Reset

IEnumCERTVIEWCOLUMN:Next

Freigeben über