Método ICertServerExit::GetRequestAttribute (certif.h)

El método GetRequestAttribute devuelve un valor de atributo con nombre de una solicitud.

Antes de llamar a este método, es necesario llamar a ICertServerExit::SetContext.

Sintaxis

HRESULT GetRequestAttribute(
  [in]  const BSTR strAttributeName,
  [out] BSTR       *pstrAttributeValue
);

Parámetros

[in] strAttributeName

Nombre del atributo que se va a recuperar.

[out] pstrAttributeValue

Puntero a un valor BSTR que contendrá el valor del atributo.

Valor devuelto

C++

Si el método se ejecuta correctamente, el método devuelve S_OK y *pstrAttributeValue se establece en el BSTR que contiene el valor del atributo.

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 pstrAttributeValue.

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.

Comentarios

Debe llamar a ICertServerExit::SetContext antes de usar este método.

Los siguientes atributos de solicitud son únicos para las solicitudes de estilo KEYGEN.

Nombre de propiedad	Tipo	Descripción
Desafío	String	Cadena de desafío que acompaña a la solicitud.
ExpectedChallenge	String	Si la cadena de desafío es incorrecta, el servidor establecerá el valor de este atributo de solicitud en el desafío esperado para que se pueda diagnosticar ese error.

 

Ejemplos

BSTR       bstrAttribValue = NULL;
HRESULT    hr;

// Get the request attribute.
// bstrAttribName is a BSTR assigned by EnumerateAttributes.
// Also, ICertServerExit::SetContext has already been
// called by pCertServerExit.
hr = pCertServerExit->GetRequestAttribute(bstrAttribName,
                                          &bstrAttribValue);

if (FAILED(hr))
{
    printf("Failed GetRequestAttribute [%x]\n", hr);
    goto error;
}
else
{

    // Successful call. Use bstrAttribValue as needed.
    // ...
}

// Done processing. Free BSTR.
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	certif.h (incluya Certsrv.h)
Library	Certidl.lib
Archivo DLL	Certcli.dll

Consulte también

ICertServerExit

ICertServerExit::SetContext