Método IEnumCERTVIEWATTRIBUTE::GetValue (certview.h)
El método GetValue recupera el valor del atributo actual en la secuencia de enumeración de atributos.
Sintaxis
HRESULT GetValue(
[out] BSTR *pstrOut
);
Parámetros
[out] pstrOut
Puntero a un tipo BSTR que contiene el valor del atributo.
Valor devuelto
C++
Si el método se ejecuta correctamente, el método devuelve S_OK y pstrOut se establece en el valor del atributo actual.Para usar este método, cree una variable de tipo BSTR , establezca la variable igual a NULL y pase la dirección de esta variable como pstrOut. Cuando haya terminado de usar BSTR, ábrelo llamando a la función SysFreeString .
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 una cadena que representa el valor del atributo actual.Comentarios
Este método se usa para recuperar los datos del atributo al que hace referencia actualmente la secuencia de enumeración de atributos.
Si la secuencia de enumeración de atributos no hace referencia a un atributo válido, Se producirá un error en GetValue . Use uno de los métodos siguientes para navegar por la enumeración :
- IEnumCERTVIEWATTRIBUTE::Reset: se mueve al principio de la secuencia de enumeración.
- IEnumCERTVIEWATTRIBUTE::Next: se mueve al siguiente atributo de la secuencia de enumeración.
- IEnumCERTVIEWATTRIBUTE::Skip: omite un número especificado de atributos.
Ejemplos
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 | 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 |