ICertRequest interface
The ICertRequest interface provides communications between a client or intermediary application and Certificate services.
Client and intermediary applications can call the ICertRequest methods to perform the following tasks:
- Submit certificate request.
- Retrieve the disposition, last status, and identifier of a request.
- Retrieve the certificate issued for the request.
- Retrieve pending certificates for previous requests.
- Retrieve the certification authority (CA) certificate for the Certificate Services server.
ICertRequest is defined in Certcli.h. When you create your program, however, use Certsrv.h as the include file. Certcli.dll provides the ICertRequest interface. The type information for this interface is also in Certclil.dll, which is shipped with the Platform Software Development Kit (SDK).
Certificate Services interfaces support both apartment-threading and free-threading models. For better throughput, free threading is recommended.
Inheritance
The ICertRequest interface is extended by the ICertRequest2 interface. All the methods defined by ICertRequest are inherited by ICertRequest2 and are documented under the newer interface.
Members
The ICertRequest interface inherits from the IDispatch interface. ICertRequest also has these types of members:
Methods
The ICertRequest interface has these methods.
| Method | Description |
|---|---|
| GetCACertificate |
Returns the CA certificate for the Certificate Services server. (Inherited from ICertRequest2ICertRequestCCertRequest) |
| GetCertificate |
Returns the certificate issued for the request. (Inherited from ICertRequest2ICertRequestCCertRequest) |
| GetDispositionMessage |
Gets a human-readable message giving the current disposition of the certificate request. (Inherited from ICertRequest2ICertRequestCCertRequest) |
| GetLastStatus |
Gets the last return code for this request. (Inherited from ICertRequest2ICertRequestCCertRequest) |
| GetRequestId |
Gets the current internal request number for the request and subsequent certificate. (Inherited from ICertRequest2ICertRequestCCertRequest) |
| RetrievePending |
Attempts to retrieve the certificate issued for an earlier request, that may have initially been made pending. (Inherited from ICertRequest2ICertRequestCCertRequest) |
| Submit |
Submits a request to the Certificate Services server. (Inherited from ICertRequest2ICertRequestCCertRequest) |
Requirements
|
Minimum supported client | Windows XP [desktop apps only] |
|---|---|
|
Minimum supported server | Windows Server 2003 [desktop apps only] |
|
Header |
|
|
Library |
|
|
DLL |
|
|
IID |
IID_ICertRequest is defined as 014E4840-5523-11D0-8812-00A0C903B83C |
Send comments about this topic to Microsoft
Build date: 10/26/2012