Metodo IEnumCERTVIEWCOLUMN::GetValue (certview.h)

Articolo
03/14/2023

Il metodo GetValue recupera il valore di dati contenuto nella colonna corrente nella sequenza di enumerazione colonna.

Sintassi

HRESULT GetValue(
  [in]  LONG    Flags,
  [out] VARIANT *pvarValue
);

Parametri

[in] Flags

Identificatore che indica il formato di output per i dati recuperati. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
CV_OUT_BASE64	BASE64 senza BEGIN/END
CV_OUT_BASE64HEADER	BASE64 con BEGIN CERTIFICATE e END CERTIFICATE
CV_OUT_BASE64REQUESTHEADER	BASE64 con BEGIN NEW CERTIFICATE REQUEST e END NEW CERTIFICATE REQUEST
CV_OUT_BASE64X509CRLHEADER	BASE64 con BEGIN X509 CRL e END X509 CRL
CV_OUT_BINARY	Binary
CV_OUT_HEX	Stringa esadecimale
CV_OUT_HEXADDR	Stringa esadecimale con indirizzo/offset
CV_OUT_HEXASCII	Stringa esadecimale con ASCII
CV_OUT_HEXASCIIADDR	Stringa esadecimale con ASCII e address/offset

[out] pvarValue

Puntatore al valore di tipo VARIANT contenente la colonna dati. Questo metodo ha esito negativo se pvarValue è NULL. Al termine di questo metodo, pvarValue contiene i dati nella colonna. Il chiamante è responsabile della chiamata a VariantClear quando viene eseguito con questi dati.

Valore restituito

C++

Se il metodo ha esito positivo, il metodo restituisce S_OK.

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 Variant che rappresenta i dati nella colonna.

Commenti

Questo metodo viene usato per recuperare i dati nella colonna a cui si fa riferimento la sequenza di enumerazione colonna.

Se la sequenza di enumerazione colonna non fa riferimento a una colonna valida, GetValue 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

HRESULT     hr;
VARIANT     var;
SYSTEMTIME  systime;

VariantInit(&var);

// pEnumCol is previously instantiated IEnumCERTVIEWCOLUMN object
hr = pEnumCol->GetValue(CV_OUT_HEX, &var);
if ( FAILED (hr) )
{
    printf("Failed GetValue - %x\n", hr);
    goto error;
}
switch( var.vt )
{
    case VT_EMPTY:
        printf( "VT_EMPTY\n" );
        break;
    case VT_BSTR:
        printf("%ws\n", var.bstrVal );
        break;
    case VT_DATE:
        VariantTimeToSystemTime( var.date, &systime );
        printf("%d.%d.%d %02d:%02d:%02d\n",
               systime.wMonth,
               systime.wDay,
               systime.wYear,
               systime.wHour,
               systime.wMinute,
               systime.wSecond );
        break;
    case VT_I2:
        printf("%d\n", var.iVal );
        break;
    case VT_I4:
        printf("%d\n", var.lVal );
        break;
    default:
        printf("type is:%i\n", var.vt );
        break;
}
// done processing, clear resources
VariantClear( &var );

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