Méthode IEnumCERTVIEWCOLUMN ::GetName (certview.h)
La méthode GetName récupère le nom non localisé de la colonne active dans la séquence d’énumération de colonnes.
Syntaxe
HRESULT GetName(
[out] BSTR *pstrOut
);
Paramètres
[out] pstrOut
Pointeur vers une variable de type BSTR qui contient le nom de la colonne.
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 la colonne.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 au format pstrOut. Une fois que 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 la colonne.Remarques
Cette méthode est utilisée pour récupérer le nom non localisé de la colonne actuellement référencée par la séquence d’énumération de colonnes.
Si la séquence d’énumération de colonnes ne fait pas référence à une colonne valide, GetName échoue. Utilisez l’une des méthodes suivantes pour parcourir l’énumération :
- IEnumCERTVIEWCOLUMN ::Reset : passe au début de la séquence d’énumération.
- IEnumCERTVIEWCOLUMN ::Next : passe à la colonne suivante de la séquence d’énumération.
- IEnumCERTVIEWCOLUMN ::Skip : ignore un nombre spécifié de colonnes.
Exemples
BSTR bstrColName = NULL;
HRESULT hr;
// pEnumCol is previously instantiated IEnumCERTVIEWCOLUMN object
hr = pEnumCol->GetName(&bstrColName);
if (S_OK == hr)
printf("Column name is %ws\n", bstrColName);
// done processing, clear resources
if (NULL != bstrColName)
SysFreeString(bstrColName);
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 (inclure Certsrv.h) |
| Bibliothèque | Certidl.lib |
| DLL | Certadm.dll |