nf-certadm-icertadmin-resubmitrequest.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:certadm.ICertAdmin.ResubmitRequest	ICertAdmin::ResubmitRequest (certadm.h)	Submits the specified certificate request to the policy module for the specified certification authority. This method was first introduced in the ICertAdmin interface.	CCertAdmin object [Security] ResubmitRequest method ICertAdmin interface [Security] ResubmitRequest method ICertAdmin.ResubmitRequest ICertAdmin2 interface [Security] ResubmitRequest method ICertAdmin2::ResubmitRequest ICertAdmin::ResubmitRequest ResubmitRequest ResubmitRequest method [Security] ResubmitRequest method [Security] CCertAdmin object ResubmitRequest method [Security] ICertAdmin interface ResubmitRequest method [Security] ICertAdmin2 interface certadm/ICertAdmin2::ResubmitRequest certadm/ICertAdmin::ResubmitRequest security.icertadmin2_resubmitrequest	security\icertadmin2_resubmitrequest.htm	security	610712d9-3661-42ba-9d2f-27862ba8dbd4	12/05/2018	CCertAdmin object [Security],ResubmitRequest method, ICertAdmin interface [Security],ResubmitRequest method, ICertAdmin.ResubmitRequest, ICertAdmin2 interface [Security],ResubmitRequest method, ICertAdmin2::ResubmitRequest, ICertAdmin::ResubmitRequest, ResubmitRequest, ResubmitRequest method [Security], ResubmitRequest method [Security],CCertAdmin object, ResubmitRequest method [Security],ICertAdmin interface, ResubmitRequest method [Security],ICertAdmin2 interface, certadm/ICertAdmin2::ResubmitRequest, certadm/ICertAdmin::ResubmitRequest, security.icertadmin2_resubmitrequest	certadm.h	Certsrv.h	Windows	None supported	Windows Server 2003 [desktop apps only]										Certidl.lib	Certadm.dll		Windows			19H1	ICertAdmin::ResubmitRequest certadm/ICertAdmin::ResubmitRequest	c++	APIRef kbSyntax	COM	Certadm.dll	ICertAdmin2.ResubmitRequest ICertAdmin.ResubmitRequest CCertAdmin.ResubmitRequest

ICertAdmin::ResubmitRequest

-description

The ResubmitRequest method submits the specified certificate request to the policy module for the specified certification authority. This method was first introduced in the ICertAdmin interface.

For this method to succeed, the certificate request must be pending.

-parameters

-param strConfig [in]

Represents a valid configuration string for the certification authority (CA) in the form COMPUTERNAME\CANAME, where COMPUTERNAME is the network name of the Certificate Services server and CANAME is the common name of the certification authority, as entered during Certificate Services setup. For information about the configuration string name, see ICertConfig.

Important  ResubmitRequest does not clear the internal cache when the configuration string is changed. When you change the configuration string for the CA, you must instantiate a new ICertAdmin object and call this method again with the new configuration string.

 

-param RequestId [in]

Specifies the ID of the request to resubmit.

-param pDisposition [out, retval]

A pointer to the disposition of the request.

-returns

C++

If the method succeeds and the pDisposition parameter is set to one of the following values that specify the disposition of the request, the method returns S_OK.

If the method fails, it returns an HRESULT value that indicates the error. For a list of common error codes, see Common HRESULT Values.

VB

The return value specifies the disposition of the request. This value is one of the following values.

Return code	Description
CR_DISP_INCOMPLETE	The request was not completed.
CR_DISP_ERROR	The request failed.
CR_DISP_DENIED	The request was denied.
CR_DISP_ISSUED	The certificate was issued.
CR_DISP_ISSUED_OUT_OF_BAND	The certificate was issued separately.
CR_DISP_UNDER_SUBMISSION	The request was taken under submission.

-remarks

Administration tasks use DCOM. Code that calls this interface method as defined in an earlier version of Certadm.h will run on Windows-based servers as long as the client and the server are both running the same Windows operating system.

Examples

#include <windows.h>
#include <stdio.h>
#include <Certadm.h>


    long nDisp;  // disposition value
    long nReqID = <REQUESTIDHERE>;
    BSTR bstrCA = NULL;

    bstrCA = SysAllocString(L"<COMPUTERNAMEHERE>\\<CANAMEHERE>");
    if (NULL == bstrCA)
    {
        printf("Memory allocation failed\n");
        goto error;
    }

    //  pCertAdmin is a previously instantiated ICertAdmin object.
    hr = pCertAdmin->ResubmitRequest(bstrCA, nReqID, &nDisp);
    if (FAILED(hr))
    {
        printf("Failed ResubmitRequest [%x]\n", hr);
        goto error;
    }
    else
        printf("ResubmitRequest disposition is %d\n", nDisp);

error:
    //  Free resources.
    if (bstrCA)
        SysFreeString(bstrCA);

-see-also

CCertAdmin

ICertAdmin

ICertAdmin2

ICertConfig

ICertRequest::Submit