ICertRequest::GetDispositionMessage-Methode (certcli.h)

Artikel
02/23/2024

Die GetDispositionMessage-Methode ruft eine lesbare Nachricht ab, die die aktuelle Disposition der Zertifikatanforderung angibt.

Beachten Sie, dass die hier zurückgegebene Nachricht möglicherweise mehr Details enthält als der zurückgegebene Fehlercode. Beispielsweise kann ICertRequest3::GetLastStatus ein HRESULT zurückgeben, während GetDispositionMessage einen detaillierten Grund zurückgibt, der angibt, warum die Anforderung abgelehnt wurde.

Syntax

HRESULT GetDispositionMessage(
  [out] BSTR *pstrDispositionMessage
);

Parameter

[out] pstrDispositionMessage

Ein Zeiger auf den BSTR , der die Dispositionsmeldung enthält.

Rückgabewert

C++

Wenn die Methode erfolgreich ist, gibt die Methode S_OK zurück.

Nach erfolgreichem Abschluss dieser Funktion wird *pstrDispositionMessage auf den BSTR festgelegt, der eine lesbare Nachricht enthält, die die aktuelle Disposition der Zertifikatanforderung angibt. Um diese Methode zu verwenden, erstellen Sie eine Variable vom Typ BSTR , legen Sie die Variable gleich NULL fest, und übergeben Sie die Adresse dieser Variablen als pstrDispositionMessage. Wenn Sie die Verwendung des BSTR abgeschlossen haben, geben Sie ihn frei, indem Sie die SysFreeString-Funktion aufrufen.

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 ist eine Zeichenfolge, die eine lesbare Nachricht enthält, die die aktuelle Disposition der Zertifikatanforderung angibt.

Hinweise

Eine Anwendung ruft diese Methode auf, um die vom Server abgerufene Nachricht mithilfe eines früheren Aufrufs von ICertRequest3::Submit oder ICertRequest3::RetrievePending abzurufen. Darüber hinaus wird die Nachricht in der Zertifikatdienste-Datenbank gespeichert und kann vom MMC-Snap-In der Zertifizierungsstelle angezeigt werden (wählen Sie die Spalte Dispositionsnachricht anfordern aus). Wenn die Nachricht lokalisierten Text enthält, wurde sie auf dem Server lokalisiert (basierend auf dem Gebietsschema des Servers).

Beispiele

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

    BSTR    bstrDispMsg = NULL;
    // pCertRequest is previously instantiated ICertRequest object 
    // pointer. Retrieve the disposition message for the 
    // previous request.
    hr = pCertRequest->GetDispositionMessage(&bstrDispMsg);
    if (FAILED(hr))
    {
        printf("Failed GetDispositionMessage [%x]\n", hr);
        goto error;
    }
    else
    {
        // Use the disposition message as needed...
    }

    // Done processing.

error:

    // Free BSTR values.
    if (NULL != bstrCA)
        SysFreeString(bstrCA);

    if (NULL != bstrDispMsg)
        SysFreeString(bstrDispMsg);

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certcli.h (include Certsrv.h)
Bibliothek	Certidl.lib
DLL	Certcli.dll