ICertServerPolicy ::EnumerateAttributes, méthode (certif.h)
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 |