ICertAdmin::ResubmitRequest-Methode (certadm.h)

Artikel
02/23/2024

Die ResubmitRequest-Methode übermittelt die angegebene Zertifikatanforderung an das Richtlinienmodul für die angegebene Zertifizierungsstelle. Diese Methode wurde erstmals in der ICertAdmin-Schnittstelle eingeführt.

Damit diese Methode erfolgreich ist, muss die Zertifikatanforderung ausstehend sein.

Syntax

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

Parameter

[in] strConfig

Stellt eine gültige Konfigurationszeichenfolge für die Zertifizierungsstelle im Format COMPUTERNAME\CANAME dar, wobei COMPUTERNAME der Netzwerkname des Zertifikatdiensteservers und CANAME der allgemeine Name der Zertifizierungsstelle ist, wie er während der Einrichtung der Zertifikatdienste eingegeben wurde. Informationen zum Namen der Konfigurationszeichenfolge finden Sie unter ICertConfig.

WichtigResubmitRequest löscht den internen Cache nicht, wenn die Konfigurationszeichenfolge geändert wird. Wenn Sie die Konfigurationszeichenfolge für die Zertifizierungsstelle ändern, müssen Sie ein neues ICertAdmin-Objekt instanziieren und diese Methode erneut mit der neuen Konfigurationszeichenfolge aufrufen.

[in] RequestId

Gibt die ID der anforderung an, die erneut übermittelt werden soll.

[out, retval] pDisposition

Ein Zeiger auf die Disposition der Anforderung.

Rückgabewert

C++

Wenn die Methode erfolgreich ist und der pDisposition-Parameter auf einen der folgenden Werte festgelegt ist, die die Disposition der Anforderung angeben, gibt die Methode S_OK zurück.

Wenn die Methode fehlschlägt, gibt sie einen HRESULT-Wert zurück, der den Fehler angibt. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

VB

Der Rückgabewert gibt die Disposition der Anforderung an. Dieser Wert ist einer der folgenden Werte.

Rückgabecode	Beschreibung
CR_DISP_INCOMPLETE	Die Anforderung wurde nicht abgeschlossen.
CR_DISP_ERROR	Fehler bei der Anforderung.
CR_DISP_DENIED	Die Anfrage wurde verweigert.
CR_DISP_ISSUED	Das Zertifikat wurde ausgestellt.
CR_DISP_ISSUED_OUT_OF_BAND	Das Zertifikat wurde separat ausgestellt.
CR_DISP_UNDER_SUBMISSION	Die Anforderung wurde im Rahmen der Übermittlung aufgenommen.

Hinweise

Verwaltungsaufgaben verwenden DCOM. Code, der diese Schnittstellenmethode aufruft, wie in einer früheren Version von Certadm.h definiert, wird auf Windows-basierten Servern ausgeführt, solange der Client und der Server dasselbe Windows-Betriebssystem ausführen.

Beispiele

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certadm.h (include Certsrv.h)
Bibliothek	Certidl.lib
DLL	Certadm.dll