IEnumCERTVIEWROW ::EnumCertViewAttribute, méthode (certview.h)

Article
02/28/2024

La méthode EnumCertViewAttribute obtient une instance d’une séquence d’énumération d’attributs pour la ligne actuelle de la séquence d’énumération de lignes.

Syntaxe

HRESULT EnumCertViewAttribute(
  [in]  LONG                   Flags,
  [out] IEnumCERTVIEWATTRIBUTE **ppenum
);

Paramètres

[in] Flags

C++	Valeur LONG . Doit être zéro.
VB	Valeur De type Long . Doit être zéro.

[out] ppenum

Pointeur vers un pointeur de type IEnumCERTVIEWATTRIBUTE . Une fois cette méthode terminée, ppenum est défini sur un pointeur de type IEnumCERTVIEWATTRIBUTE .

Valeur retournée

C++

Si la méthode réussit, la méthode retourne S_OK.

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 retournée est un objet séquence d’attributs d’énumération.

Remarques

La séquence d’énumération d’attributs obtenue par cet appel peut être utilisée pour énumérer les attributs associés au certificat dans la ligne active. Cette énumération est accessible via les méthodes de l’interface IEnumCERTVIEWATTRIBUTE .

Pour référencer une autre ligne, appelez l’une des méthodes suivantes pour parcourir la séquence d’énumération de lignes :

IEnumCERTVIEWROW ::Reset : se déplace au début de la séquence d’énumération.
IEnumCERTVIEWROW ::Next : passe à la ligne suivante dans la séquence d’énumération.
IEnumCERTVIEWROW ::Skip : ignore un nombre spécifié de lignes.

Exemples

// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW
HRESULT                  hr;
LONG                     Index;
IEnumCERTVIEWATTRIBUTE * pEnumAttr = NULL;

// obtain enumerator for attributes
hr = pEnumRow->EnumCertViewAttribute(0, &pEnumAttr);
if (FAILED(hr))
{
    printf("Failed EnumCertViewAttribute - %x\n", hr);
    goto error;
}
// enumerate each attribute
while (S_OK == pEnumAttr->Next(&Index))
{
    // Use this attribute as needed.
}
error:

// Free resources.
if (NULL != pEnumAttr)
    pEnumAttr->Release();

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