IEnumCERTVIEWATTRIBUTE ::GetName, méthode (certview.h)
La méthode GetName récupère le nom de l’attribut actuel dans la séquence d’énumération d’attributs.
Syntaxe
HRESULT GetName(
[out] BSTR *pstrOut
);
Paramètres
[out] pstrOut
Pointeur vers une variable de type BSTR qui contient 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 pstrOut contient le nom de l’attribut.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 pstrOut. 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
La valeur de retour est une chaîne qui contient le nom de l’attribut.Remarques
Cette méthode est utilisée pour récupérer le nom de l’attribut actuellement référencé par la séquence d’énumération d’attributs.
Si la séquence d’énumération d’attributs ne fait pas référence à un attribut valide, GetName échoue. Utilisez l’une des méthodes suivantes pour parcourir l’énumération :
- IEnumCERTVIEWATTRIBUTE ::Reset : se déplace au début de la séquence d’énumération.
- IEnumCERTVIEWATTRIBUTE ::Next : passe à l’attribut suivant dans la séquence d’énumération.
- IEnumCERTVIEWATTRIBUTE ::Skip : ignore un nombre spécifié d’attributs.
Exemples
BSTR bstrAttribName = NULL;
// pEnumAttr is previously instantiated IEnumCERTVIEWATTRIBUTE object
hr = pEnumAttr->GetName(&bstrAttribName);
if (S_OK != hr)
printf("Failed call to GetName - %x\n", hr);
else
printf("Attribute name is %ws\n", bstrAttribName );
// free memory when done
if (NULL != bstrAttribName)
SysFreeString(bstrAttribName);
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 |
Voir aussi
IEnumCERTVIEWATTRIBUTE ::GetValue
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour