Metodo IEnumCERTVIEWCOLUMN::GetDisplayName (certview.h)

Articolo
03/14/2023

Il metodo GetDisplayName recupera il nome localizzato della colonna corrente nella sequenza di enumerazione di colonna.

Sintassi

HRESULT GetDisplayName(
  [out] BSTR *pstrOut
);

Parametri

[out] pstrOut

Puntatore a una variabile di tipo BSTR contenente il nome localizzato della colonna.

Valore restituito

C++

Se il metodo ha esito positivo, il metodo restituisce S_OK e il parametro pstrOut contiene il nome localizzato della colonna.

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 localizzato della colonna.

Commenti

Questo metodo viene usato per recuperare il nome localizzato della colonna a cui fa attualmente riferimento la sequenza di enumerazione di colonna.

Se la sequenza di enumerazione di colonna non fa riferimento a una colonna valida, GetDisplayName avrà esito negativo. Usare uno dei metodi seguenti per spostarsi nell'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     bstrDisplay = NULL;
HRESULT  hr;

// pEnumCol is previously instantiated IEnumCERTVIEWCOLUMN object.
hr = pEnumCol->GetDisplayName(&bstrDisplay);
if (S_OK == hr)
    printf("Column name is %ws\n", bstrDisplay);

// Done processing, clear resources.
if (NULL != bstrDisplay)
    SysFreeString(bstrDisplay);

Requisiti


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