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

Article
02/26/2024

La méthode EnumerateAttributes récupère le nom de l’attribut actuel et déplace le pointeur d’énumération interne vers l’attribut suivant.

Syntaxe

HRESULT EnumerateAttributes(
  [out] BSTR *pstrAttributeName
);

Paramètres

[out] pstrAttributeName

Pointeur vers le nom de l’attribut.

Valeur retournée

C++

Si la méthode réussit, la méthode retourne S_OK et le paramètre pstrAttributeName est défini sur un BSTR qui contient le nom de l’attribut. Une valeur de S_FALSE est retournée si le dernier attribut a déjà été énuméré.

Pour utiliser cette méthode, créez une variable de type BSTR , définissez la variable sur NULL, puis transmettez l’adresse de cette variable en tant que pstrAttributeName.

Lorsque vous avez terminé d’utiliser le BSTR, libérez-le en appelant la fonction SysFreeString .

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

Retourne une chaîne qui contient le nom de l’attribut, ou une chaîne vide si le dernier attribut a déjà été énuméré.

Remarques

Avant d’appeler la méthode EnumerateAttributes pour la première fois, appelez la méthode EnumerateAttributesSetup pour initialiser le pointeur d’énumération vers le premier attribut.

Lorsque vous avez terminé l’énumération, appelez
la méthode EnumerateAttributesClose pour libérer les ressources utilisées par les appels d’énumération.

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