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(
  IX509CertificateRequest *pRequest
);

Parameters

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
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
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

   
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

See also

IX509CertificateRequest

IX509CertificateRequestCmc

IX509CertificateRequestPkcs10

IX509CertificateRequestPkcs7

IX509Enrollment