Méthode IEnumCERTVIEWCOLUMN ::Skip (certview.h)

Article
02/23/2024

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

Syntaxe

HRESULT Skip(
  [in] LONG celt
);

Paramètres

[in] celt

Nombre de colonnes à ignorer. Une valeur positive pour le paramètre celt entraîne l’avance de la séquence d’énumération de colonnes dans la séquence d’énumération. Une valeur négative fait que l’énumération de colonnes passe en arrière 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 qu’une valeur négative dans le paramètre celt a entraîné une valeur inférieure à zéro de l’index de séquence d’énumération de colonnes.

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 fonction terminée, appelez la méthode IEnumCERTVIEWCOLUMN ::Next pour référencer la colonne actuelle dans la séquence d’énumération de colonne. Une fois ce deuxième appel effectué, les informations de la colonne peuvent être obtenues en appelant l’une des méthodes suivantes :

IEnumCERTVIEWCOLUMN ::GetName : récupère le nom non localisé de la colonne.
IEnumCERTVIEWCOLUMN ::GetDisplayName : récupère le nom localisé de la colonne.
IEnumCERTVIEWCOLUMN ::GetValue : récupère les données dans la colonne.
IEnumCERTVIEWCOLUMN ::GetType : récupère le type de données dans la colonne.
IEnumCERTVIEWCOLUMN ::GetMaxLength : récupère la longueur maximale, en octets, de la colonne.

La séquence d’énumération de colonnes 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

HRESULT  hr;
LONG     Index;

// pEnumCol is previously instantiated IEnumCERTVIEWCOLUMN object
// skip the next five columns
hr = pEnumCol->Skip(5);
if (S_OK == hr) 
{
    // get the next column
    hr = pEnumCol->Next(&Index);
    if (S_OK == hr)
    {
        // Use this column 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 (include Certsrv.h)
Bibliothèque	Certidl.lib
DLL	Certadm.dll