Méthode IEnumCERTVIEWROW ::EnumCertViewColumn (certview.h)

Article
02/28/2024

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

Syntaxe

HRESULT EnumCertViewColumn(
  [out] IEnumCERTVIEWCOLUMN **ppenum
);

Paramètres

[out] ppenum

Pointeur vers un pointeur de type IEnumCERTVIEWCOLUMN .

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 de retour est un objet de séquence d’énumération de colonnes.

Remarques

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

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 : passe 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

// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW
HRESULT               hr;
LONG                  Index;
IEnumCERTVIEWCOLUMN * pEnumCol = NULL;
// obtain enumerator for columns
hr = pEnumRow->EnumCertViewColumn(&pEnumCol);
if ( FAILED( hr ))
{
    printf("Failed EnumCertViewColumn - %x\n", hr );
    goto error;
}
// enumerate each column
while (S_OK == pEnumCol->Next(&Index))
{
    // Use this column as needed.
}
error:

// Free resources.
if ( NULL != pEnumCol )
    pEnumCol->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 (inclure Certsrv.h)
Bibliothèque	Certidl.lib
DLL	Certadm.dll