Metodo IEnumCERTVIEWATTRIBUTE::Skip (certview.h)

Articolo
08/22/2023

Il metodo Skip ignora un numero specificato di attributi nella sequenza di enumerazione degli attributi.

Sintassi

HRESULT Skip(
  [in] LONG celt
);

Parametri

[in] celt

Numero di attributi da ignorare. Un valore positivo per il parametro celt fa sì che la sequenza di enumerazione dell'attributo salti avanti nella sequenza. Un valore negativo per il parametro celt fa sì che la sequenza di enumerazione dell'attributo 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 attributo diventi 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 IEnumCERTVIEWATTRIBUTE::Next per fare riferimento all'attributo corrente nella sequenza di enumerazione attributi. È possibile accedere al nome e al valore dell'attributo tramite i metodi seguenti:

La sequenza di enumerazione attributo gestisce un indice interno in base zero. La chiamata al metodo Skip fa sì che l'indice aumenti o diminuisca in base al numero di attributi specificati 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 IEnumCERTVIEWATTRIBUTE::Next non è definito.

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

Esempio

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

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

IEnumCERTVIEWATTRIBUTE

IEnumCERTVIEWATTRIBUTE::Reset

IEnumCERTVIEWATTRIBUTE:Next

Condividi tramite