Metodo ICertServerPolicy::GetRequestAttribute (certif.h)

  • Articolo

Il metodo GetRequestAttribute restituisce un attributo denominato da una richiesta.

Sintassi

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

Parametri

[in] strAttributeName

Nome dell'attributo da recuperare.

[out] pstrAttributeValue

Puntatore a un valore BSTR che conterrà il valore dell'attributo.

Valore restituito

C++

Se il metodo ha esito positivo, il metodo restituisce S_OK e *pstrAttributeValue è impostato su BSTR che contiene il valore dell'attributo.

Per usare questo metodo, creare una variabile di tipo BSTR, impostare la variabile su NULL e passare l'indirizzo di questa variabile come pstrAttributeValue.

Al termine dell'uso di BSTR, liberarlo chiamando la funzione SysFreeString .

Se il metodo ha esito negativo, restituisce un valore HRESULT che indica l'errore. Per un elenco dei codici di errore comuni, vedere Valori HRESULT comuni.

VB

Il valore restituito è una stringa che rappresenta il valore dell'attributo.

Commenti

È necessario chiamare ICertServerPolicy::SetContext prima di usare questo metodo.

Gli attributi di richiesta seguenti sono univoci per le richieste di stile KEYGEN.

Nome proprietà Type Descrizione
Sfida Stringa Stringa di verifica che accompagna la richiesta.
ExpectedChallenge Stringa Se la stringa di verifica non è corretta, il server imposterà il valore di questo attributo della richiesta sulla richiesta prevista in modo che sia possibile diagnosticare l'errore.
 

Esempio

BSTR     bstrAttribValue = NULL;
HRESULT  hr;

// Get the request attribute.
// bstrAttribName is BSTR assigned by EnumerateAttributes.
// pCertServerPolicy has been used to call SetContext previously.
hr = pCertServerPolicy->GetRequestAttribute(bstrAttribName,
                                            &bstrAttribValue);

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

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

// Done processing. Free BSTR.
if (NULL != bstrAttribValue)
    SysFreeString(bstrAttribValue);

Requisiti

Requisito Valore
Client minimo supportato Nessuno supportato
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione certif.h (include Certsrv.h)
Libreria Certidl.lib
DLL Certcli.dll

Vedi anche

ICertServerPolicy

ICertServerPolicy::SetContext