Compartir a través de

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

  • Artículo

[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