IEnumCERTVIEWROW ::EnumCertViewAttribute, méthode (certview.h)
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 |