Export (0) Print
Expand All

ICEnroll4::enumPendingRequest method

[This method is no longer available for use as of Windows Server 2008 and Windows Vista.]

The enumPendingRequest method enumerates pending certificate requests and retrieves a specified property from each. This method was first defined in the ICEnroll4 interface.

Syntax


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

Parameters

lIndex [in]

Specifies the ordinal position of the pending request whose property will be retrieved. Specify zero for the first request.

lDesiredProperty [in]

The identifier for the property being retrieved. This parameter can be one of the following values.

ValueMeaning
XEPR_CADNS

The DNS name for the certification authority (CA).

XEPR_CAFRIENDLYNAME

The display name of the CA.

XEPR_CANAME

The name of the CA.

XEPR_HASH

The hash value of the request.

XEPR_REQUESTID

The certificate request ID.

 

pvarProperty [out]

A pointer to a VARIANT that receives the value of the retrieved property.

When you have finished using the VARIANT, free it by calling the VariantClear function.

Return value

C++

If the method succeeds, the method returns S_OK.

If the method fails, it returns an HRESULT value that indicates the error. For a list of common error codes, see Common HRESULT Values.

If the following values are specified for lDesiredProperty, this method returns E_NOTIMPL:

  • XEPR_DATE
  • XEPR_V1TEMPLATENAME
  • XEPR_V2TEMPLATEOID
  • XEPR_VERSION

If you specify any other value for lDesiredProperty this method returns E_INVALIDARG.

VB

Returns a Variant that contains a property from a pending request.

Remarks

This method is disabled when the Certificate Enrollment Control is executed as a scripted control.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

End of client support

Windows XP

End of server support

Windows Server 2003

Header

Xenroll.h

Library

Uuid.lib

DLL

Xenroll.dll

IID

IID_ICEnroll4 is defined as c1f1188a-2eb5-4a80-841b-7e729a356d90

 

 

Community Additions

ADD
Show:
© 2014 Microsoft