Edit

IEnroll4::enumPendingRequestWStr method (xenroll.h)

  • Article

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

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

Syntax

HRESULT enumPendingRequestWStr(
  [in]  LONG   lIndex,
  [in]  LONG   lDesiredProperty,
  [out] LPVOID ppProperty
);

Parameters

[in] lIndex

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

[in] lDesiredProperty

Identifier for the property being retrieved. Specify one of the following values.

Value Meaning
XEPR_CADNS
 DNS name for the certification authority (CA).
XEPR_CAFRIENDLYNAME
 Display name of the CA.
XEPR_CANAME
 Name of the CA.
XEPR_HASH
 Hash value of the request.
XEPR_REQUESTID
 Certificate request ID.

[out] ppProperty

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

Return value

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.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header xenroll.h
Library Uuid.lib
DLL Xenroll.dll

See also

IEnroll4