ICertRequest::Submit

The Submit method submits a request to the certificate server.

[VB] long Submit(
  long Flags,          
  BSTR strRequest,     
  BSTR strAttributes,  
  BSTR  strConfig      
);
 
[JAVA] int Submit(
  int Flags,                    
  java.lang.String strRequest,  
  java.lang.String strAttributes,  
  java.lang.String strConfig    
);
 
[C++] HRESULT Submit(
  LONG Flags,                // in
  BSTR const strRequest,     // in
  BSTR const strAttributes,  // in
  BSTR const strConfig,      // in
  LONG *pDisposition         // out, return value
);

Parameters

[VB][JAVA][C++] Flags
Specifies the request format, type of request and whether the request is encrypted. One of the following format attribute flags can be used to specify how the request is encoded.
Format Attribute Flags Description
CR_IN_BASE64HEADER BASE64 format with begin/end.
CR_IN_BASE64 BASE64 format without begin/end.
CR_IN_BINARY Binary format.

One of the following format value flags can be used to specify the type of the request.
Format Value Flags Description
CR_IN_PKCS10 PKCS 10 request
CR_IN_KEYGEN Keygen request

One of the following encryption flags can be used to specify encrypted content. (In the case of encrypted content, the server will look at content as a PKCS#7 encrypted message, encrypted to the exchange key of the server.)
Encryption Flags Description
CR_IN_ENCRYPTED_REQUEST Request encrypted
CR_IN_ENCRYPTED_ATTRIBUTES Attributes encrypted

[VB][JAVA][C++] strRequest
Points to the string containing the certificate request.
[VB][JAVA][C++] strAttributes
Points to the string containing extra attributes for the request.
[VB][JAVA][C++] strConfig
Points to a valid configuration string for the certificate server. See ICertConfig::GetConfig.
[C++] pDisposition
Points to the return value. See Return Values.

Return Values

Returns a value specifying the disposition of the request. The disposition can be specified by one of the following values.

Return Value Meaning
CR_DISP_INCOMPLETE Request did not complete
CR_DISP_ERROR Request failed
CR_DISP_DENIED Request denied
CR_DISP_ISSUED Certificate issued
CR_DISP_ISSUED_OUT_OF_BAND Certificate issued separately
CR_DISP_UNDER_SUBMISSION Request taken under submission

QuickInfo

  Windows NT: Requires version 5.0 or later (or version 4.0 with the Windows NT 4.0 Option Pack).
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in certcli.h.
  Import Library: Use certidl.lib.