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

  • Artigo

[Esse método não está mais disponível para uso a partir do Windows Server 2008 e do Windows Vista.]

O método enumPendingRequest enumera solicitações de certificado pendentes e recupera uma propriedade especificada de cada uma.

Esse método foi definido pela primeira vez na interface ICEnroll4 .

Sintaxe

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

Parâmetros

[in] lIndex

Especifica a posição ordinal da solicitação pendente cuja propriedade será recuperada. Especifique zero para a primeira solicitação.

[in] lDesiredProperty

O identificador da propriedade que está sendo recuperada. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
XEPR_CADNS
 O nome DNS da AC (autoridade de certificação ).
XEPR_CAFRIENDLYNAME
 O nome de exibição da AC.
XEPR_CANAME
 O nome da AC.
XEPR_HASH
 O valor de hash da solicitação.
XEPR_REQUESTID
 A ID da solicitação de certificado.

[out] pvarProperty

Um ponteiro para um VARIANT que recebe o valor da propriedade recuperada.

Quando terminar de usar o VARIANT, libere-o chamando a função VariantClear .

Retornar valor

C++

Se o método for bem-sucedido, o método retornará S_OK.

Se o método falhar, ele retornará um valor HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Se os seguintes valores forem especificados para lDesiredProperty, esse método retornará E_NOTIMPL:

  • XEPR_DATE
  • XEPR_V1TEMPLATENAME
  • XEPR_V2TEMPLATEOID
  • XEPR_VERSION

Se você especificar qualquer outro valor para lDesiredProperty , esse método retornará E_INVALIDARG.

VB

Retorna um Variant que contém uma propriedade de uma solicitação pendente.

Comentários

Esse método é desabilitado quando o Controle de Registro de Certificado é executado como um controle com script.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho xenroll.h
Biblioteca Uuid.lib
DLL Xenroll.dll