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

Article
02/27/2024

La méthode EnumerateAttributes retourne le nom de l’attribut de requête suivant dans le contexte actuel, puis incrémente le pointeur interne vers l’attribut suivant.

Avant d’appeler EnumerateAttributes, une application appelle ICertServerExit ::EnumerateAttributesSetup. Une fois l’énumération terminée, une application appelle ICertServerExit ::EnumerateAttributesClose.

Syntaxe

HRESULT EnumerateAttributes(
  [out] BSTR *pstrAttributeName
);

Paramètres

[out] pstrAttributeName

Pointeur vers le nom de l’attribut énuméré.

Valeur retournée

C++

Si la méthode réussit, la méthode retourne S_OK et *pstrAttributeName est défini sur le BSTR qui contient le nom de l’attribut énuméré. 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 et 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 énuméré, ou une chaîne vide si le dernier attribut a déjà été énuméré.

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