IEnumCERTVIEWROW::Skip, méthode (certview.h)

Article
08/22/2023

La méthode Skip ignore un nombre spécifié de lignes dans la séquence d’énumération de lignes.

Syntaxe

HRESULT Skip(
  [in] LONG celt
);

Paramètres

[in] celt

Nombre de lignes à ignorer. Une valeur positive pour le paramètre celt entraîne l’avance de la séquence d’énumération de lignes dans la séquence d’énumération. Une valeur négative pour le paramètre celt entraîne l’envers de la séquence d’énumération de lignes dans la séquence d’énumération.

Valeur retournée

VB

Si la méthode réussit, la méthode retourne S_OK.

Une valeur de retour de E_INVALIDARG indique que le paramètre celt a été défini sur un nombre négatif, ce qui a entraîné une diminution de l’index de séquence d’énumération de lignes.

Si la méthode échoue, elle retourne une valeur HRESULT qui indique l’erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Notes

Une fois cette méthode terminée, appelez la méthode IEnumCERTVIEWROW::Skip pour référencer la ligne actuelle dans la séquence d’énumération de lignes. Une fois ce deuxième appel effectué, les colonnes, les attributs et les extensions associés au certificat dans la ligne peuvent être énumérés à l’aide des méthodes des interfaces suivantes :

La séquence d’énumération de lignes conserve un index interne de base zéro. L’appel à la méthode Skip entraîne une augmentation ou une diminution de cet index en fonction du paramètre celt .

Si une valeur négative du paramètre celt fait que l’index est inférieur à zéro, le comportement des appels suivants à Next n’est pas défini.

Si une valeur positive du paramètre celt provoque le dépassement de l’index de la dernière ligne de la séquence d’énumération, un appel ultérieur à la méthode Next échoue.

Exemples

// 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();

Configuration requise


Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	certview.h (include Certsrv.h)
Bibliothèque	Certidl.lib
DLL	Certadm.dll