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

Artículo
02/23/2024

El método ResubmitRequest envía la solicitud de certificado especificada al módulo de directiva para la entidad de certificación especificada. Este método se introdujo por primera vez en la interfaz ICertAdmin .

Para que este método se realice correctamente, la solicitud de certificado debe estar pendiente.

Sintaxis

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

Parámetros

[in] strConfig

Representa una cadena de configuración válida para la entidad de certificación (CA) con el formato COMPUTERNAME\CANAME, donde COMPUTERNAME es el nombre de red del servidor de Servicios de certificados y CANAME es el nombre común de la entidad de certificación, tal como se especifica durante la instalación de Servicios de certificados. Para obtener información sobre el nombre de la cadena de configuración, vea ICertConfig.

ImportanteResubmitRequest no borra la memoria caché interna cuando se cambia la cadena de configuración. Al cambiar la cadena de configuración de la entidad de certificación, debe crear una instancia de un nuevo objeto ICertAdmin y llamar a este método de nuevo con la nueva cadena de configuración.

[in] RequestId

Especifica el identificador de la solicitud que se va a volver a enviar.

[out, retval] pDisposition

Puntero a la disposición de la solicitud.

Valor devuelto

C++

Si el método se ejecuta correctamente y el parámetro pDisposition se establece en uno de los valores siguientes que especifican la disposición de la solicitud, el método devuelve S_OK.

Si se produce un error en el método, devuelve un valor HRESULT que indica el error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

VB

El valor devuelto especifica la disposición de la solicitud. Este valor es uno de los siguientes valores.

Código devuelto	Descripción
CR_DISP_INCOMPLETE	No se completó la solicitud.
CR_DISP_ERROR	Error en la solicitud.
CR_DISP_DENIED	Se ha denegado la solicitud.
CR_DISP_ISSUED	Se emitió el certificado.
CR_DISP_ISSUED_OUT_OF_BAND	El certificado se emitió por separado.
CR_DISP_UNDER_SUBMISSION	La solicitud se realizó en su envío.

Comentarios

Las tareas de administración usan DCOM. El código que llama a este método de interfaz tal como se define en una versión anterior de Certadm.h se ejecutará en servidores basados en Windows siempre que el cliente y el servidor ejecuten el mismo sistema operativo Windows.

Ejemplos

#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	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	certadm.h (incluya Certsrv.h)
Library	Certidl.lib
Archivo DLL	Certadm.dll