ICertServerPolicy ::EnumerateAttributesSetup, méthode (certif.h)

Article
02/23/2024

La méthode EnumerateAttributesSetup initialise le pointeur d’énumération interne vers le premier attribut de requête associé au contexte actuel.

Syntaxe

HRESULT EnumerateAttributesSetup(
  [in] LONG Flags
);

Paramètres

[in] Flags

Ce paramètre est réservé et doit être défini sur zéro.

Valeur retournée

VB

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.

Remarques

La méthode SetContext doit être appelée avant d’appeler cette méthode. L’appel à SetContext spécifie la requête à utiliser comme contexte actuel.

Pour récupérer l’attribut, appelez la méthode EnumerateAttributes . L’appel à EnumerateAttributes récupère le premier attribut et déplace l’index vers l’attribut suivant s’il en existe un.

Exemples

// Set the context. The value nContext (long) would be the same
// as the context parameter in ICertPolicy::VerifyRequest.
// hr is defined as an HRESULT.
// pCertServerPolicy has been used to call SetContext previously.
hr = pCertServerPolicy->SetContext(nContext);
if (FAILED(hr))
{
    printf("Failed SetContext [%x]\n", hr);
    goto error;
}

// Setup the enumeration.
hr = pCertServerPolicy->EnumerateAttributesSetup(0);
if (FAILED(hr))
{
    printf("Failed EnumerateAttributesSetup [%x]\n", hr);
    goto error;
}

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	certif.h (include Certsrv.h)
Bibliothèque	Certidl.lib
DLL	Certcli.dll