Metodo IEnumCERTVIEWROW::Skip (certview.h)

Articolo
03/14/2023

Il metodo Skip ignora un numero specificato di righe nella sequenza di enumerazione di riga.

Sintassi

HRESULT Skip(
  [in] LONG celt
);

Parametri

[in] celt

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

Valore restituito

VB

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

Un valore restituito di E_INVALIDARG indica che il parametro celt è stato impostato su un numero negativo che ha causato che l'indice della sequenza di enumerazione di riga 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 IEnumCERTVIEWROW::Skip per fare riferimento alla riga corrente nella sequenza di enumerazione di riga. Dopo aver eseguito questa seconda chiamata, è possibile enumerare le colonne, gli attributi e le estensioni associati al certificato nella riga usando i metodi delle interfacce seguenti:

La sequenza di enumerazione di riga mantiene un indice interno in base zero. La chiamata al metodo Skip fa sì che questo indice aumenti o diminuisca in base all'impostazione del parametro celt .

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

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

Esempio

// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW.
HRESULT  hr;
LONG     Index;
// Reposition the row enumerator to the beginning of the rows.
hr = pEnumRow->Reset();
if (FAILED(hr))
{
    printf("Unable to reset pEnumRow\n");
    goto error;
}
// Skip some rows.
hr = pEnumRow->Skip(5);
if (FAILED(hr))
{
    printf("Unable to skip rows\n");
    goto error;
}

// Get the next row.
hr = pEnumRow->Next(&Index);
if (S_OK == hr)
{
    // Use this row as needed.
}

error:

if (NULL != pEnumRow)
    pEnumRow->Release();

Requisiti


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