Metodo IEnumCERTVIEWATTRIBUTE::GetName (certview.h)
Il metodo GetName recupera il nome dell'attributo corrente nella sequenza di enumerazione attributo.
Sintassi
HRESULT GetName(
[out] BSTR *pstrOut
);
Parametri
[out] pstrOut
Puntatore a una variabile di tipo BSTR che contiene il nome dell'attributo.
Valore restituito
C++
Se il metodo ha esito positivo, il metodo restituisce S_OK e il parametro pstrOut contiene il nome dell'attributo.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 contiene il nome dell'attributo.Commenti
Questo metodo viene usato per recuperare il nome dell'attributo a cui fa riferimento la sequenza di enumerazione attributo.
Se la sequenza di enumerazione dell'attributo non fa riferimento a un attributo valido, GetName 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 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);
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 |