Metodo IEnumCERTVIEWATTRIBUTE::GetValue (certview.h)
Il metodo GetValue recupera il valore dell'attributo corrente nella sequenza di enumerazione dell'attributo.
Sintassi
HRESULT GetValue(
[out] BSTR *pstrOut
);
Parametri
[out] pstrOut
Puntatore a un tipo BSTR che contiene il valore dell'attributo.
Valore restituito
C++
Se il metodo ha esito positivo, il metodo restituisce S_OK e pstrOut viene impostato sul valore dell'attributo corrente.Per usare questo metodo, creare una variabile di tipo BSTR , impostare la variabile su NULL e passare l'indirizzo di questa variabile come pstrOut. Al termine dell'uso di BSTR, liberarlo chiamando la funzione SysFreeString .
Se il metodo ha esito negativo, restituisce un valore HRESULT che indica l'errore. Per un elenco dei codici di errore comuni, vedere Valori HRESULT comuni.
VB
Il valore restituito è string che rappresenta il valore dell'attributo corrente.Commenti
Questo metodo viene usato per recuperare i dati nell'attributo a cui fa riferimento la sequenza di enumerazione attributo.
Se la sequenza di enumerazione dell'attributo non fa riferimento a un attributo valido, GetValue avrà esito negativo. Usare uno dei metodi seguenti per spostarsi nell'enumerazione :
- IEnumCERTVIEWATTRIBUTE::Reset: passa all'inizio della sequenza di enumerazione.
- IEnumCERTVIEWATTRIBUTE::Next: passa all'attributo successivo nella sequenza di enumerazione.
- IEnumCERTVIEWATTRIBUTE::Skip: ignora un numero specificato di attributi.
Esempio
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);
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Nessuno supportato |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | certview.h (include Certsrv.h) |
| Libreria | Certidl.lib |
| DLL | Certadm.dll |