Método ICEnroll4::enumPendingRequest (xenroll.h)

[Este método ya no está disponible para su uso a partir de Windows Server 2008 y Windows Vista.]

El método enumPendingRequest enumera las solicitudes de certificado pendientes y recupera una propiedad especificada de cada una.

Este método se definió por primera vez en la interfaz ICEnroll4 .

Sintaxis

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

Parámetros

[in] lIndex

Especifica la posición ordinal de la solicitud pendiente cuya propiedad se recuperará. Especifique cero para la primera solicitud.

[in] lDesiredProperty

Identificador de la propiedad que se va a recuperar. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
XEPR_CADNS	Nombre DNS de la entidad de certificación (CA).
XEPR_CAFRIENDLYNAME	Nombre para mostrar de la ENTIDAD de certificación.
XEPR_CANAME	Nombre de la ENTIDAD de certificación.
XEPR_HASH	Valor hash de la solicitud.
XEPR_REQUESTID	Identificador de solicitud de certificado.

[out] pvarProperty

Puntero a un variant que recibe el valor de la propiedad recuperada.

Cuando haya terminado de usar variant, álelelo llamando a la función VariantClear .

Valor devuelto

C++

Si el método se realiza correctamente, el método devuelve S_OK.

Si se produce un error en el método, devuelve un valor HRESULT que indica el error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Si se especifican los valores siguientes para lDesiredProperty, este método devuelve E_NOTIMPL:

• XEPR_DATE
• XEPR_V1TEMPLATENAME
• XEPR_V2TEMPLATEOID
• XEPR_VERSION

Si especifica cualquier otro valor para lDesiredProperty , este método devuelve E_INVALIDARG.

VB

Devuelve un valor Variant que contiene una propiedad de una solicitud pendiente.

Comentarios

Este método se deshabilita cuando el control de inscripción de certificados se ejecuta como un control con scripts.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	xenroll.h
Library	Uuid.lib
Archivo DLL	Xenroll.dll