Sends a Certificate Exchange Messaging (CEM) request.
int SendCEMRequest(const QString& qsRequestId);
This method send the Certificate Exchange Messaging (CEM) request with the details specified in CEMDetails.
Certificate Exchange Messaging (CEM) allows for new certificates to be sent to a recipient and be automatically updated. This removes the requirement to manually send new certificates to a partner via email or other means. When both sides support this functionality updating certificates can be accomplished in a short period of time.
To prepare a CEM request populate the CEMDetails collection with at least one certificate. For instance if the certificate of the application will be updated soon, the CEMDetails may be populated with the corresponding public certificate to be sent to your partner. CEMDetails should only contain public certificates.
Set CEMRespondByDate to the date by which you expect a response. The format is of the XML standard dateTime type expressed in local time with UTC offset. For instance: "2005-08-31T00:21:00-05:00".
Optionally set CEMCertId to a friendly identifier that the partner may use to help understand the purpose of the new certificate. For instance "New.Encryption.Cert.2014".
Set CEMResponseURL to the publicly accessible URL where the CEM response will be sent after the partner processes it.
The RequestId parameter uniquely identifies this CEM request and must be saved for use later when receiving the CEM response.
When calling this method the applicable CEMDetails properties are:
- CEMCertUsage (optional)
- CEMCertId (optional)
This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)