Método ICertServerExit::GetRequestAttribute (certif.h)
O método GetRequestAttribute retorna um valor de atributo nomeado de uma solicitação.
Antes de chamar esse método, é necessário chamar ICertServerExit::SetContext.
Sintaxe
HRESULT GetRequestAttribute(
[in] const BSTR strAttributeName,
[out] BSTR *pstrAttributeValue
);
Parâmetros
[in] strAttributeName
O nome do atributo a ser recuperado.
[out] pstrAttributeValue
Um ponteiro para um valor BSTR que conterá o valor do atributo.
Retornar valor
C++
Se o método for bem-sucedido, o método retornará S_OK e *pstrAttributeValue será definido como o BSTR que contém o valor do atributo.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 pstrAttributeValue.
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 é uma cadeia de caracteres que representa o valor do atributo.Comentários
Você deve chamar ICertServerExit::SetContext antes de usar esse método.
Os atributos de solicitação a seguir são exclusivos para solicitações de estilo KEYGEN.
| Nome da propriedade | Type | Descrição |
|---|---|---|
| Desafio | Cadeia de caracteres | Cadeia de caracteres de desafio que acompanha a solicitação. |
| ExpectedChallenge | Cadeia de caracteres | Se a cadeia de caracteres de desafio estiver incorreta, o servidor definirá o valor desse atributo de solicitação para o desafio esperado para que a falha possa ser diagnosticada. |
Exemplos
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 | 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 | certif.h (inclua Certsrv.h) |
| Biblioteca | Certidl.lib |
| DLL | Certcli.dll |