Partager via


IEnumCERTVIEWATTRIBUTE ::GetValue, méthode (certview.h)

La méthode GetValue récupère la valeur de l’attribut actuel dans la séquence d’énumération d’attributs.

Syntaxe

HRESULT GetValue(
  [out] BSTR *pstrOut
);

Paramètres

[out] pstrOut

Pointeur vers un type BSTR qui contient la valeur de l’attribut .

Valeur retournée

C++

Si la méthode réussit, la méthode retourne S_OK et le pstrOut est défini sur la valeur de l’attribut actuel.

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 représente la valeur de l’attribut actuel.

Remarques

Cette méthode est utilisée pour récupérer les données dans 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, GetValue échoue. Utilisez l’une des méthodes suivantes pour parcourir l’énumération :

Exemples

BSTR    bstrAttribValue = NULL;

// pEnumAttr is previously instantiated IEnumCERTVIEWATTRIBUTE object
hr = pEnumAttr->GetValue(&bstrAttribValue);
if (S_OK != hr)
    printf("Failed call to GetValue - %x\n", hr);
else
    printf("Attribute value is %ws\n",bstrAttribValue);

// free memory when done
if (NULL != bstrAttribValue)
    SysFreeString(bstrAttribValue);

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

IEnumCERTVIEWATTRIBUTE ::GetName

IEnumCERTVIEWATTRIBUTE ::Next

IEnumCERTVIEWATTRIBUTE ::Reset

IEnumCERTVIEWATTRIBUTE ::Skip