Méthode IEnumCERTVIEWROW ::GetMaxIndex (certview.h)
La méthode GetMaxIndex récupère la valeur d’index valide maximale une fois que toutes les lignes de la séquence d’énumération de lignes ont été référencées.
Syntaxe
HRESULT GetMaxIndex(
[out] LONG *pIndex
);
Paramètres
[out] pIndex
Pointeur vers une variable LONG qui contient la valeur d’index maximale pour la séquence d’énumération de lignes. 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 pIndex est défini sur la valeur d’index maximale pour la séquence d’énumération de lignes.Si la traversée jusqu’à la dernière ligne n’a pas eu lieu, cette méthode échoue avec une valeur de retour de E_UNEXPECTED.
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 maximale pour la séquence d’énumération de lignes. Cette méthode échoue si la traversée jusqu’à la dernière ligne n’a pas eu lieu.Remarques
La réussite de cette méthode dépend de l’atteinte de la dernière ligne de la séquence d’énumération. L’index de ligne maximal peut être utile pour dimensionner une barre de défilement ou une fenêtre d’affichage, mais il peut également être gourmand en ressources pour le calcul, car il nécessite l’évaluation de l’ensemble de la requête. Pour certaines requêtes, les données de colonne de chaque ligne doivent être examinées afin de déterminer si elles sont incluses dans la vue. Une fois que l’utilisateur a paginé toutes les données ou a explicitement demandé de passer à la fin, l’index de ligne maximal est conservé.
Pour parcourir la séquence d’énumération de lignes, appelez les méthodes suivantes.
| Méthode | Description |
|---|---|
| IEnumCERTVIEWROW ::Reset | Se déplace au début de la séquence d’énumération. |
| IEnumCERTVIEWROW ::Next | Passe à la ligne suivante de la séquence d’énumération. |
| IEnumCERTVIEWROW ::Skip | Ignore un nombre spécifié de lignes. |
Exemples
#include <windows.h>
#include <stdio.h>
#include <Certview.h>
long nMax;
// Determine the maximum row index.
hr = pRow->GetMaxIndex(&nMax);
if (FAILED(hr))
printf("Failed GetMaxIndex [%x]\n", hr);
else
printf("Max index is: %d\n", nMax);
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 |
Voir aussi
IEnumCERTVIEWROW