Condividi tramite

Metodo ICEnroll4::enumPendingRequest (xenroll.h)

  • Articolo

[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