Metodo IEnumCERTVIEWEXTENSION::Skip (certview.h)

Articolo
08/22/2023

Il metodo Skip ignora un numero specificato di estensioni nella sequenza di enumerazione di estensione.

Sintassi

HRESULT Skip(
  [in] LONG celt
);

Parametri

[in] celt

Numero di estensioni da ignorare. Un valore positivo per il parametro celt fa sì che la sequenza di enumerazione di estensione salti avanti nella sequenza. Un valore negativo per il parametro celt fa sì che la sequenza di enumerazione di estensione ignori all'indietro nella sequenza.

Valore restituito

VB

Se il metodo ha esito positivo, il metodo restituisce S_OK.

Un valore restituito di E_INVALIDARG indica che un valore negativo per il parametro celt ha causato che l'indice della sequenza di enumerazione di estensione diventa minore di zero.

Se il metodo ha esito negativo, restituisce un valore HRESULT che indica l'errore. Per un elenco dei codici di errore comuni, vedere Valori HRESULT comuni.

Commenti

Al termine di questo metodo, chiamare il metodo IEnumCERTVIEWEXTENSION::Next per fare riferimento all'estensione corrente nella sequenza di enumerazione di estensione. È possibile accedere al nome dell'estensione, ai flag e al valore tramite i metodi seguenti:

La sequenza di enumerazione di estensione gestisce un indice interno in base zero. La chiamata al metodo Skip fa sì che questo indice aumenti o diminuisca del numero di estensioni specificato nel parametro celt .

Se un valore negativo del parametro celt fa sì che l'indice sia minore di zero, il comportamento delle chiamate successive a IEnumCERTVIEWEXTENSION::Next non è definito.

Se un valore positivo del parametro celt fa sì che l'indice superi l'ultima estensione nella sequenza di enumerazione, una chiamata successiva al metodo IEnumCERTVIEWEXTENSION::Next avrà esito negativo.

Esempio

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.
    }
}

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	certview.h (include Certsrv.h)
Libreria	Certidl.lib
DLL	Certadm.dll