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

Artigo
02/23/2024

O método GetValue recupera o valor do atributo atual na sequência attribute-enumeration.

Sintaxe

HRESULT GetValue(
  [out] BSTR *pstrOut
);

Parâmetros

[out] pstrOut

Um ponteiro para um tipo BSTR que contém o valor do atributo .

Retornar valor

C++

Se o método for bem-sucedido, o método retornará S_OK e o pstrOut será definido como o valor do atributo atual.

Para usar esse método, crie uma variável do tipo BSTR , defina a variável igual a NULL e passe o endereço dessa variável como pstrOut. Quando terminar de usar o BSTR, libere-o chamando a função SysFreeString .

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 String que representa o valor do atributo atual.

Comentários

Esse método é usado para recuperar os dados no atributo atualmente referenciado pela sequência attribute-enumeration.

Se a sequência attribute-enumeration não estiver fazendo referência a um atributo válido, GetValue falhará. Use um dos seguintes métodos para navegar pela enumeração:

IEnumCERTVIEWATTRIBUTE::Reset: move para o início da sequência de enumeração.
IEnumCERTVIEWATTRIBUTE::Next: move para o próximo atributo na sequência de enumeração.
IEnumCERTVIEWATTRIBUTE::Skip: ignora um número especificado de atributos.

Exemplos

BSTR    bstrAttribValue = NULL;

// pEnumAttr is previously instantiated IEnumCERTVIEWATTRIBUTE object
hr = pEnumAttr->GetValue(&bstrAttribValue);
if (S_OK != hr)
    printf("Failed call to GetValue - %x\n", hr);
else
    printf("Attribute value is %ws\n",bstrAttribValue);

// free memory when done
if (NULL != bstrAttribValue)
    SysFreeString(bstrAttribValue);

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