Método IEnumCERTVIEWATTRIBUTE::GetValue (certview.h)
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 |