Método IEnumCERTVIEWCOLUMN::GetValue (certview.h)

Artículo
08/22/2023

El método GetValue recupera el valor de datos contenido en la columna actual de la secuencia de enumeración de columnas.

Sintaxis

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

Parámetros

[in] Flags

Identificador que indica el formato de salida de los datos recuperados. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
CV_OUT_BASE64	BASE64 sin BEGIN/END
CV_OUT_BASE64HEADER	BASE64 con BEGIN CERTIFICATE y END CERTIFICATE
CV_OUT_BASE64REQUESTHEADER	BASE64 con BEGIN NEW CERTIFICATE REQUEST y END NEW CERTIFICATE REQUEST
CV_OUT_BASE64X509CRLHEADER	BASE64 con BEGIN X509 CRL y END X509 CRL
CV_OUT_BINARY	Binary
CV_OUT_HEX	Cadena hexadecimal
CV_OUT_HEXADDR	Cadena hexadecimal con dirección/desplazamiento
CV_OUT_HEXASCII	Cadena hexadecimal con ASCII
CV_OUT_HEXASCIIADDR	Cadena hexadecimal con ASCII y dirección/desplazamiento

[out] pvarValue

Puntero al valor de tipo VARIANT que contiene la columna de datos. Este método produce un error si pvarValue es NULL. Tras completar correctamente este método, pvarValue contiene los datos de la columna. El autor de la llamada es responsable de llamar a VariantClear cuando haya terminado con estos datos.

Valor devuelto

C++

Si el método se realiza correctamente, el método devuelve S_OK.

Si se produce un error en el método, devuelve un valor HRESULT que indica el error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

VB

El valor devuelto es un valor Variant que representa los datos de la columna.

Comentarios

Este método se usa para recuperar los datos de la columna a los que hace referencia actualmente la secuencia de enumeración de columnas.

Si la secuencia de enumeración de columnas no hace referencia a una columna válida, Se producirá un error en GetValue . Use uno de los métodos siguientes para navegar por la enumeración :

IEnumCERTVIEWCOLUMN::Reset: se mueve al principio de la secuencia de enumeración.
IEnumCERTVIEWCOLUMN::Next: se mueve a la siguiente columna de la secuencia de enumeración.
IEnumCERTVIEWCOLUMN::Skip: omite un número especificado de columnas.

Ejemplos

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 );

Requisitos

Requisito	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	certview.h (incluya Certsrv.h)
Library	Certidl.lib
Archivo DLL	Certadm.dll