Partager via

Méthode IEnumCERTVIEWROW ::Next (certview.h)

  • Article

La méthode Next passe à la ligne suivante de la séquence d’énumération de lignes.

Syntaxe

HRESULT Next(
  [out] LONG *pIndex
);

Paramètres

[out] pIndex

Pointeur vers une variable qui contient la valeur d’index de la ligne suivante référencée. S’il n’y a plus de lignes à énumérer, cette variable est définie sur –1. Cette méthode échoue si pIndex a la valeur NULL.

Valeur retournée

C++

Si la méthode réussit, la méthode retourne S_OK et la ligne suivante est désormais référencée par la séquence d’énumération de lignes. S’il n’y a plus de lignes à énumérer, S_FALSE est retourné et pIndex est défini sur la valeur –1.

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.

VB

La valeur de retour est la valeur d’index de la ligne qui est désormais référencée par la séquence d’énumération de lignes. S’il n’y a plus de lignes à énumérer, la valeur de retour est –1.

Remarques

Une fois cette méthode terminée, 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 :

Le calcul de toutes les lignes de la séquence d’énumération peut demander beaucoup de ressources, en fonction de la requête impliquée et de la taille de la séquence.

Exemples

// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW.
LONG  Index;
LONG  nCount;

// Ensure enumerator is at first row.
if (FAILED(pEnumRow->Reset()))
    printf("Failed to Reset\n");
else
{
    nCount = 0;
    // Count the database records by enumerating the rows.
    while (S_OK == pEnumRow->Next(&Index))
        nCount++;
    // Display number of records.
    printf("Number of records is %d\n", nCount);
}

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

Voir aussi

IEnumCERTVIEWATTRIBUTE

IEnumCERTVIEWCOLUMN

IEnumCERTVIEWEXTENSION

IEnumCERTVIEWROW