Método ICertRequest::GetDispositionMessage (certcli.h)

Artículo
02/26/2024

El método GetDispositionMessage obtiene un mensaje legible que proporciona la disposición actual de la solicitud de certificado.

Tenga en cuenta que el mensaje devuelto aquí puede tener más detalles que el código de error devuelto. Por ejemplo, ICertRequest3::GetLastStatus puede devolver un HRESULT, mientras que GetDispositionMessage devolverá un motivo detallado que especifica por qué se denegó la solicitud.

Sintaxis

HRESULT GetDispositionMessage(
  [out] BSTR *pstrDispositionMessage
);

Parámetros

[out] pstrDispositionMessage

Puntero al BSTR que contiene el mensaje de eliminación.

Valor devuelto

C++

Si el método se realiza correctamente, el método devuelve S_OK.

Una vez completada correctamente esta función, *pstrDispositionMessage se establece en el BSTR que contiene un mensaje legible que proporciona la disposición actual de la solicitud de certificado. Para usar este método, cree una variable de tipo BSTR , establezca la variable igual a NULL y pase la dirección de esta variable como pstrDispositionMessage. Cuando haya terminado de usar el BSTR, áurelo llamando a la función SysFreeString .

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 es una cadena que contiene un mensaje legible que proporciona la disposición actual de la solicitud de certificado.

Comentarios

Una aplicación llamaría a este método para obtener el mensaje recuperado del servidor mediante una llamada anterior a ICertRequest3::Submit o ICertRequest3::RetrievePending. Además, el mensaje se almacena en la base de datos de Servicios de certificados y puede verse mediante el complemento MMC de la entidad de certificación (elija la columna Mensaje de eliminación de solicitudes). Si el mensaje contiene texto localizado, se ha localizado en el servidor (en función de la configuración regional del servidor).

Ejemplos

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

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	certcli.h (incluya Certsrv.h)
Library	Certidl.lib
Archivo DLL	Certcli.dll