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

Artigo
08/22/2023

O método GetValue recupera o valor de dados contido na coluna atual na sequência de enumeração de coluna.

Sintaxe

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

Parâmetros

[in] Flags

Um identificador que indica o formato de saída para os dados recuperados. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
CV_OUT_BASE64	BASE64 sem BEGIN/END
CV_OUT_BASE64HEADER	BASE64 com BEGIN CERTIFICATE e END CERTIFICATE
CV_OUT_BASE64REQUESTHEADER	BASE64 COM BEGIN NEW CERTIFICATE REQUEST E END NEW CERTIFICATE REQUEST
CV_OUT_BASE64X509CRLHEADER	BASE64 com BEGIN X509 CRL e END X509 CRL
CV_OUT_BINARY	Binário
CV_OUT_HEX	Cadeia de caracteres hexadecimal
CV_OUT_HEXADDR	Cadeia de caracteres hexadecimal com endereço/deslocamento
CV_OUT_HEXASCII	Cadeia de caracteres hexadecimal com ASCII
CV_OUT_HEXASCIIADDR	Cadeia de caracteres hexadecimal com ASCII e endereço/deslocamento

[out] pvarValue

Um ponteiro para o valor do tipo VARIANT que contém a coluna de dados. Esse método falhará se pvarValue for NULL. Após a conclusão bem-sucedida desse método, pvarValue contém os dados na coluna. O chamador é responsável por chamar VariantClear quando terminar com esses dados.

Retornar valor

C++

Se o método for bem-sucedido, o método retornará S_OK.

Se o método falhar, ele retornará um valor HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

VB

O valor retornado é um Variant que representa os dados na coluna.

Comentários

Esse método é usado para recuperar os dados na coluna que está sendo referenciada atualmente pela sequência de enumeração de coluna.

Se a sequência de enumeração de coluna não estiver fazendo referência a uma coluna válida, GetValue falhará. Use um dos seguintes métodos para navegar pela enumeração:

IEnumCERTVIEWCOLUMN::Reset: move para o início da sequência de enumeração.
IEnumCERTVIEWCOLUMN::Next: move para a próxima coluna na sequência de enumeração.
IEnumCERTVIEWCOLUMN::Skip: ignora um número especificado de colunas.

Exemplos

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	Valor
Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	certview.h (inclua Certsrv.h)
Biblioteca	Certidl.lib
DLL	Certadm.dll