IX509Enrollment::InitializeFromRequest method (certenroll.h)
The InitializeFromRequest method initializes the enrollment object from an existing IX509CertificateRequest object. This method is web enabled.
Syntax
HRESULT InitializeFromRequest(
[in] IX509CertificateRequest *pRequest
);
Parameters
[in] pRequest
Pointer to the IX509CertificateRequest interface.
Return value
If the function succeeds, the function returns S_OK.
If the function fails, it returns an HRESULT value that indicates the error. Possible values include, but are not limited to, those in the following table. For a list of common error codes, see Common HRESULT Values.
| Return code/value | Description |
|---|---|
|
The enrollment object has already been initialized. |
Remarks
The InitializeFromRequest method:
- Verifies that the request is a PKCS #10, PKCS #7, or CMC request object.
- Retrieves the template, if any, associated with the request.
- Validates the template.
- Sets the request object on the Request property.
- Retrieves the signature count, issuance policies, and application policies from the template.
- Retrieves the renewal certificate if one exists.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2008 [desktop apps only] |
| Target Platform | Windows |
| Header | certenroll.h |
| DLL | CertEnroll.dll |