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

Article
02/28/2024

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

Syntaxe

HRESULT Skip(
  [in] LONG celt
);

Paramètres

[in] celt

Nombre d’extensions à ignorer. Une valeur positive pour le paramètre celt entraîne l’ignorer de la séquence d’énumération d’extension 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’extension 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’extension.

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 IEnumCERTVIEWEXTENSION ::Next pour référencer l’extension actuelle dans la séquence d’énumération d’extension. Le nom de l’extension, les indicateurs et la valeur sont accessibles via les méthodes suivantes :

La séquence d’énumération d’extension gère 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’extensions spécifiées 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 à IEnumCERTVIEWEXTENSION ::Next n’est pas défini.

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

Exemples

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

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