IEnroll4::enumPendingRequestWStr method (xenroll.h)
[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 |
---|---|
|
DNS name for the certification authority (CA). |
|
Display name of the CA. |
|
Name of the CA. |
|
Hash value of the request. |
|
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 |