Metodo IEnumCERTVIEWCOLUMN::GetName (certview.h)
Il metodo GetName recupera il nome non localizzato della colonna corrente nella sequenza di enumerazione colonna.
Sintassi
HRESULT GetName(
[out] BSTR *pstrOut
);
Parametri
[out] pstrOut
Puntatore a una variabile di tipo BSTR contenente il nome della colonna.
Valore restituito
C++
Se il metodo ha esito positivo, il metodo restituisce S_OK e il parametro pstrOut contiene il nome della colonna.Per usare questo metodo, creare una variabile di tipo BSTR , impostare la variabile uguale a NULL e passare l'indirizzo di questa variabile come pstrOut. Al termine dell'uso della funzione BSTR, liberarla chiamando la funzione SysFreeString .
Se il metodo ha esito negativo, restituisce un valore HRESULT che indica l'errore. Per un elenco di codici di errore comuni, vedere Valori HRESULT comuni.
VB
Il valore restituito è un valore String che contiene il nome della colonna.Commenti
Questo metodo viene usato per recuperare il nome non localizzato della colonna a cui fa riferimento la sequenza di enumerazione colonna.
Se la sequenza di enumerazione colonna non fa riferimento a una colonna valida, GetName avrà esito negativo. Usare uno dei metodi seguenti per esplorare l'enumerazione:
- IEnumCERTVIEWCOLUMN::Reset: passa all'inizio della sequenza di enumerazione.
- IEnumCERTVIEWCOLUMN::Next: Passa alla colonna successiva nella sequenza di enumerazione.
- IEnumCERTVIEWCOLUMN::Skip: Ignora un numero specificato di colonne.
Esempio
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);
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Nessuno supportato |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | certview.h (includere Certsrv.h) |
| Libreria | Certidl.lib |
| DLL | Certadm.dll |