Metodo ICertServerPolicy::GetRequestProperty (certif.h)

Articolo
02/26/2024

Il metodo GetRequestProperty recupera una proprietà specifica da una richiesta.

Sintassi

HRESULT GetRequestProperty(
  [in]  const BSTR strPropertyName,
  [in]  LONG       PropertyType,
  [out] VARIANT    *pvarPropertyValue
);

Parametri

[in] strPropertyName

Specifica il nome della proprietà da recuperare. Questo parametro può essere impostato su una proprietà name o una proprietà della richiesta.

Le proprietà dei nomi includono un set di scorte di proprietà del certificato sempre valide e che possono essere recuperate chiamando questo metodo. Per informazioni su queste proprietà, vedere Proprietà dei nomi.

Le proprietà della richiesta sono univoche per le richieste e includono i valori possibili seguenti.

Valore	Significato
RequestID Con segno lungo	REQUESTID interno.
RawRequest Binary	Byte di richiesta non elaborati.
RequestAttributes string	Stringa di attributo (può essere troncata).
RequestType Con segno lungo	Indica la richiesta PKCS #10 o KeyGen. Per altre informazioni su questa proprietà, vedere Osservazioni.
InviatoWhen Data/ora	Quando è arrivato.
RequesterName string	Nome del richiedente nel formato "DomainName\UserID".

Nota Sono disponibili proprietà di richiesta aggiuntive a cui non è possibile accedere tramite GetRequestProperty perché non vengono impostate fino al termine dell'elaborazione della richiesta da parte del modulo criteri. Inoltre, altre proprietà possono essere impostate da un tipo di richiesta, estensioni di richiesta o da attributi denominati impostati nell'intestazione di una richiesta.

[in] PropertyType

Specifica il tipo di proprietà. Il parametro PropertyType può essere uno dei tipi seguenti.

Valore	Significato
PROPTYPE_LONG	Dati lunghi firmati.
PROPTYPE_DATE	Data/ora.
PROPTYPE_BINARY	Dati binari.
PROPTYPE_STRING	Dati stringa Unicode .

[out] pvarPropertyValue

Puntatore a VARIANT che contiene il tipo di proprietà della richiesta.

Valore restituito

C++

Se il metodo ha esito positivo, il metodo restituisce S_OK e il parametro pvarPropertyValue contiene la proprietà request.

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 è la proprietà della richiesta.

Commenti

Il metodo SetContext deve essere chiamato prima di chiamare questo metodo. La chiamata a SetContext specifica la richiesta utilizzata come contesto corrente.

Le richieste contengono tutti gli stati associati per la richiesta e il certificato eventualmente concesso che non fa parte del certificato. Di conseguenza, i dati come i tempi di revoca e i dati di eliminazione vengono conservati nell'oggetto dati della richiesta.

La proprietà RequestType può essere impostata su uno dei valori seguenti.

Valore	Significato
CR_IN_PKCS	La richiesta è una richiesta di rinnovo o registrazione PKCS #7.
CR_IN-PKCS10	La richiesta è una richiesta PKCS #10.
CR_IN_KEYGEN	La richiesta è una richiesta Keygen (formato Netscape).

Esempio

BSTR      bstrPropName = NULL;
VARIANT   varProp;

VariantInit( &varProp );

bstrPropName = SysAllocString(L"RequestID");

// Retrieve the request property.
// pCertServerPolicy has been used to call SetContext previously.
hr = pCertServerPolicy->GetRequestProperty( bstrPropName,
                                          PROPTYPE_LONG,
                                          &varProp );
if (FAILED(hr))
{
    printf("Failed GetRequestProperty [%x]\n", hr);
    goto error;
}
else
{
    // Successfully retrieved property; use varProp as needed.
    // ...
}

// Done processing.
VariantClear( &varProp );
if ( NULL != bstrPropName )
    SysFreeString( bstrPropName );

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