Metodo IEnumCERTVIEWEXTENSION::Skip (certview.h)
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 |
Vedi anche
IEnumCERTVIEWEXTENSION::GetFlags
IEnumCERTVIEWEXTENSION::GetName