IEnumCERTVIEWATTRIBUTE ::Next, méthode (certview.h)

Article
02/23/2024

La méthode Next passe à l’attribut suivant dans la séquence d’énumération d’attributs.

Syntaxe

HRESULT Next(
  [out] LONG *pIndex
);

Paramètres

[out] pIndex

Pointeur vers une variable qui contient la valeur d’index de l’attribut suivant référencé. S’il n’y a plus d’attributs à é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’attribut suivant est désormais référencé par la séquence d’énumération d’attributs. S’il n’y a plus d’attributs, la méthode retourne S_FALSE et pIndex a 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’attribut qui est désormais référencé par la séquence d’énumération d’attributs. S’il n’y a plus d’attributs à énumérer, la valeur de retour est –1.

Remarques

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

Exemples

LONG       Index;
HRESULT    hr;
BSTR       bstrAttribName = NULL;

// pEnumAttr is previously instantiated IEnumCERTVIEWATTRIBUTE object
while (S_OK == pEnumAttr->Next(&Index))
{
    // retrieve the attribute name
    hr = pEnumAttr->GetName(&bstrAttribName);
    if (FAILED(hr))
        printf("Failed GetName -  %x\n", hr );
    else
        printf("Attribute name: %ws\n", bstrAttribName);
}

// Free resources.
if (NULL != bstrAttribName)
    SysFreeString(bstrAttribName);

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