Méthode IEnumCERTVIEWROW ::Next (certview.h)
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 |