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

Article
08/22/2023

La méthode Next passe à l’extension suivante dans la séquence extension-énumération.

Syntaxe

HRESULT Next(
  [out] LONG *pIndex
);

Paramètres

[out] pIndex

Pointeur vers une variable qui contient la valeur d’index de l’extension suivante référencée. S’il n’y a plus d’extensions à é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 l’extension suivante est désormais référencée. S’il n’y a plus d’extensions, S_FALSE est retourné et le paramètre 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 l’extension qui est désormais référencée par la séquence d’énumération d’extension. S’il n’y a plus d’extensions à énumérer, la valeur de retour est –1.

Remarques

Une fois cette méthode terminée, le nom de l’extension, les indicateurs et la valeur sont accessibles via les méthodes suivantes :

Exemples

LONG  Index;
LONG  nCount;

// determine the number of extensions
nCount = 0;
// pEnumExt is previously instantiated IEnumCERTVIEWEXTENSION object
while (S_OK == pEnumExt->Next(&Index))
{
    nCount++;
}
printf("Number of extensions is %d\n", nCount);

Configuration requise


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