IX509CertificateRequest::ResetForEncode method (certenroll.h)
The ResetForEncode method restores the state of the request object to that which existed before the Encode method was called.
Syntax
HRESULT ResetForEncode();
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 |
|---|---|
|
Certificate extensions and attributes have not been defined. |
|
The request object is not encoded. |
|
The object is not initialized. |
Remarks
You can use this method to reconfigure (re-encode and re-sign) a certificate request in response to rejection of the request by a certification authority. The signature and the raw data are cleared. The extensions and attributes are reset to the values they had before the Encode method was called, but critical extension flags are not. For a CMC request object, each nested request is also reset.
This method is typically used for a CMC key archival request when the private key is encrypted and included in the request.
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 |