Metodo ICertRequest::GetDispositionMessage (certcli.h)

Articolo
02/26/2024

Il metodo GetDispositionMessage ottiene un messaggio leggibile che fornisce l'eliminazione corrente della richiesta di certificato.

Si noti che il messaggio restituito qui potrebbe avere più dettagli rispetto al codice di errore restituito. Ad esempio, ICertRequest3::GetLastStatus può restituire un HRESULT, mentre GetDispositionMessage restituirà un motivo dettagliato che specifica il motivo per cui la richiesta è stata negata.

Sintassi

HRESULT GetDispositionMessage(
  [out] BSTR *pstrDispositionMessage
);

Parametri

[out] pstrDispositionMessage

Puntatore a BSTR che contiene il messaggio di eliminazione.

Valore restituito

C++

Se il metodo ha esito positivo, il metodo restituisce S_OK.

Al termine di questa funzione, *pstrDispositionMessage è impostato su BSTR che contiene un messaggio leggibile che fornisce l'eliminazione corrente della richiesta di certificato. Per usare questo metodo, creare una variabile di tipo BSTR , impostare la variabile su NULL e passare l'indirizzo di questa variabile come pstrDispositionMessage. Al termine dell'uso di BSTR, liberarlo chiamando la funzione SysFreeString .

Se il metodo ha esito negativo, restituisce un valore HRESULT che indica l'errore. Per un elenco dei codici di errore comuni, vedere Valori HRESULT comuni.

VB

Il valore restituito è una stringa che contiene un messaggio leggibile che fornisce l'eliminazione corrente della richiesta di certificato.

Commenti

Un'applicazione chiamerà questo metodo per ottenere il messaggio recuperato dal server tramite una chiamata precedente a ICertRequest3::Submit o ICertRequest3::RetrievePending. Inoltre, il messaggio viene archiviato nel database di Servizi certificati e può essere visualizzato dallo snap-in MMC Autorità di certificazione (scegliere la colonna Request Disposition Message). Se il messaggio contiene testo localizzato, è stato localizzato nel server (in base alle impostazioni locali del server).

Esempio

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	certcli.h (include Certsrv.h)
Libreria	Certidl.lib
DLL	Certcli.dll