Metodo IEnumCERTVIEWCOLUMN::GetName (certview.h)

Articolo
02/26/2024

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