Metodo ICEnroll4::enumPendingRequest (xenroll.h)

Articolo
03/04/2024

[Questo metodo non è più disponibile per l'uso a partire da Windows Server 2008 e Windows Vista.]

Il metodo enumPendingRequest enumera le richieste di certificato in sospeso e recupera una proprietà specificata da ognuna.

Questo metodo è stato definito per la prima volta nell'interfaccia ICEnroll4 .

Sintassi

HRESULT enumPendingRequest(
  [in]  LONG    lIndex,
  [in]  LONG    lDesiredProperty,
  [out] VARIANT *pvarProperty
);

Parametri

[in] lIndex

Specifica la posizione ordinale della richiesta in sospeso la cui proprietà verrà recuperata. Specificare zero per la prima richiesta.

[in] lDesiredProperty

Identificatore della proprietà da recuperare. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
XEPR_CADNS	Nome DNS per l'autorità di certificazione (CA).
XEPR_CAFRIENDLYNAME	Nome visualizzato della CA.
XEPR_CANAME	Nome della CA.
XEPR_HASH	Valore hash della richiesta.
XEPR_REQUESTID	ID richiesta certificato.

[out] pvarProperty

Puntatore a un valore VARIANT che riceve il valore della proprietà recuperata.

Al termine dell'uso di VARIANT, liberarlo chiamando la funzione VariantClear .

Valore restituito

C++

Se il metodo ha esito positivo, il metodo restituisce S_OK.

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.

Se per lDesiredProperty vengono specificati i valori seguenti, questo metodo restituisce E_NOTIMPL:

XEPR_DATE
XEPR_V1TEMPLATENAME
XEPR_V2TEMPLATEOID
XEPR_VERSION

Se si specifica un altro valore per lDesiredProperty , questo metodo restituisce E_INVALIDARG.

VB

Restituisce un valore Variant che contiene una proprietà da una richiesta in sospeso.

Commenti

Questo metodo viene disabilitato quando il controllo di registrazione certificati viene eseguito come controllo con script.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	xenroll.h
Libreria	Uuid.lib
DLL	Xenroll.dll

Condividi tramite