ICertAdmin ::ResubmitRequest, méthode (certadm.h)

Article
08/22/2023

La méthode ResubmitRequest envoie la demande de certificat spécifiée au module de stratégie pour l’autorité de certification spécifiée. Cette méthode a été introduite pour la première fois dans l’interface ICertAdmin .

Pour que cette méthode réussisse, la demande de certificat doit être en attente.

Syntaxe

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

Paramètres

[in] strConfig

Représente une chaîne de configuration valide pour l’autorité de certification sous la forme COMPUTERNAME\CANAME, où COMPUTERNAME est le nom réseau du serveur des services de certificats et CANAME le nom commun de l’autorité de certification, tel qu’entré lors de l’installation des services de certificats. Pour plus d’informations sur le nom de la chaîne de configuration, consultez ICertConfig.

ImportantResubmitRequest n’efface pas le cache interne lorsque la chaîne de configuration est modifiée. Lorsque vous modifiez la chaîne de configuration de l’autorité de certification, vous devez instancier un nouvel objet ICertAdmin et appeler à nouveau cette méthode avec la nouvelle chaîne de configuration.

[in] RequestId

Spécifie l’ID de la demande à renvoyer.

[out, retval] pDisposition

Pointeur vers la disposition de la requête.

Valeur retournée

C++

Si la méthode réussit et que le paramètre pDisposition est défini sur l’une des valeurs suivantes qui spécifient la disposition de la requête, la méthode retourne S_OK.

Si la méthode échoue, elle retourne une valeur HRESULT qui indique l’erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

VB

La valeur de retour spécifie la disposition de la requête. Cette valeur est l’une des valeurs suivantes.

Code de retour	Description
CR_DISP_INCOMPLETE	La demande n’a pas été effectuée.
CR_DISP_ERROR	La demande a échoué.
CR_DISP_DENIED	La demande a été rejetée.
CR_DISP_ISSUED	Le certificat a été émis.
CR_DISP_ISSUED_OUT_OF_BAND	Le certificat a été émis séparément.
CR_DISP_UNDER_SUBMISSION	La demande a été prise en considération.

Remarques

Les tâches d’administration utilisent DCOM. Le code qui appelle cette méthode d’interface telle que définie dans une version antérieure de Certadm.h s’exécute sur les serveurs Windows tant que le client et le serveur exécutent tous les deux le même système d’exploitation Windows.

Exemples

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	certadm.h (include Certsrv.h)
Bibliothèque	Certidl.lib
DLL	Certadm.dll