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

Article
03/01/2024

La méthode EnumCertViewExtension obtient un instance d’une séquence d’extension-énumération pour la ligne actuelle de la séquence d’énumération de lignes.

Syntaxe

HRESULT EnumCertViewExtension(
  [in]          LONG                   Flags,
  [out, retval] IEnumCERTVIEWEXTENSION **ppenum
);

Paramètres

[in] Flags

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

[out, retval] ppenum

Pointeur vers un pointeur de type IEnumCERTVIEWEXTENSION .

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’extension-énumération.

Remarques

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

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.
LONG       Index;
HRESULT    hr;
IEnumCERTVIEWEXTENSION * pEnumExt = NULL;
// Obtain enumerator for extensions.
hr = pEnumRow->EnumCertViewExtension(0, &pEnumExt);
if (FAILED(hr))
{
    printf("Failed EnumCertViewExtension - %x\n", hr);
    goto error;
}
// Enumerate each extension.
while (S_OK == pEnumExt->Next(&Index))
{
    // Use this extension as needed.
}
error:

// Free resources.
if (NULL != pEnumExt)
    pEnumExt->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