Método ICertAdmin::ResubmitRequest (certadm.h)

Artigo
02/26/2024

O método ResubmitRequest envia a solicitação de certificado especificada para o módulo de política para a autoridade de certificação especificada. Esse método foi introduzido pela primeira vez na interface ICertAdmin .

Para que esse método seja bem-sucedido, a solicitação de certificado deve estar pendente.

Sintaxe

HRESULT ResubmitRequest(
  [in]          const BSTR strConfig,
  [in]          LONG       RequestId,
  [out, retval] LONG       *pDisposition
);

Parâmetros

[in] strConfig

Representa uma cadeia de caracteres de configuração válida para a AC (autoridade de certificação ) no formato COMPUTERNAME\CANAME, em que COMPUTERNAME é o nome de rede do servidor dos Serviços de Certificados e CANAME é o nome comum da autoridade de certificação, conforme inserido durante a instalação dos Serviços de Certificados. Para obter informações sobre o nome da cadeia de caracteres de configuração, consulte ICertConfig.

ImportanteResubmitRequest não limpa o cache interno quando a cadeia de caracteres de configuração é alterada. Ao alterar a cadeia de caracteres de configuração para a AC, você deve instanciar um novo objeto ICertAdmin e chamar esse método novamente com a nova cadeia de caracteres de configuração.

[in] RequestId

Especifica a ID da solicitação a ser reenviada.

[out, retval] pDisposition

Um ponteiro para a disposição da solicitação.

Retornar valor

C++

Se o método for bem-sucedido e o parâmetro pDisposition for definido como um dos valores a seguir que especificam a disposição da solicitação, o método retornará S_OK.

Se o método falhar, ele retornará um valor HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

VB

O valor retornado especifica a disposição da solicitação. Esse valor é um dos valores a seguir.

Código de retorno	Descrição
CR_DISP_INCOMPLETE	A solicitação não foi concluída.
CR_DISP_ERROR	A solicitação falhou.
CR_DISP_DENIED	A solicitação foi negada.
CR_DISP_ISSUED	O certificado foi emitido.
CR_DISP_ISSUED_OUT_OF_BAND	O certificado foi emitido separadamente.
CR_DISP_UNDER_SUBMISSION	A solicitação foi feita sob envio.

Comentários

As tarefas de administração usam o DCOM. O código que chama esse método de interface conforme definido em uma versão anterior do Certadm.h será executado em servidores baseados no Windows, desde que o cliente e o servidor estejam executando o mesmo sistema operacional Windows.

Exemplos

#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);

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	certadm.h (inclua Certsrv.h)
Biblioteca	Certidl.lib
DLL	Certadm.dll