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

Article
02/23/2024

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

Syntaxe

HRESULT Skip(
  [in] LONG celt
);

Paramètres

[in] celt

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

Valeur retournée

VB

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

Une valeur de retour de E_INVALIDARG indique qu’une valeur négative pour le paramètre celt a entraîné une valeur inférieure à zéro à l’index de séquence d’énumération d’attributs.

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.

Remarques

Une fois cette méthode terminée, appelez la méthode IEnumCERTVIEWATTRIBUTE ::Next pour référencer l’attribut actuel dans la séquence d’énumération d’attributs. Le nom et la valeur de l’attribut sont accessibles à l’aide des méthodes suivantes :

La séquence d’énumération d’attributs conserve un index de base zéro interne. L’appel à la méthode Skip entraîne une augmentation ou une diminution de cet index du nombre d’attributs spécifiés dans le 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 à IEnumCERTVIEWATTRIBUTE ::Next n’est pas défini.

Si une valeur positive du paramètre celt fait que l’index dépasse le dernier attribut de la séquence d’énumération, un appel ultérieur à la méthode IEnumCERTVIEWATTRIBUTE ::Next échoue.

Exemples

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

Configuration requise

Condition requise	Valeur
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 (inclure Certsrv.h)
Bibliothèque	Certidl.lib
DLL	Certadm.dll