Metodo ICertServerPolicy::GetRequestAttribute (certif.h)

Articolo
02/26/2024

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

Condividi tramite