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

Artículo
02/23/2024

El método GetLastStatus obtiene el último código de retorno para esta solicitud. Esto devuelve la información del código de error, en lugar de la disposición de la solicitud.

Sintaxis

HRESULT GetLastStatus(
  [out] LONG *pStatus
);

Parámetros

[out] pStatus

Puntero al código de estado de la solicitud.

Valor devuelto

C++

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

Tras completar correctamente esta función, *pStatus se establece en el código de resultado de la última llamada a ICertRequest3::Submit, ICertRequest3::RetrievePending o ICertRequest3::GetCACertificate.

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 el código de resultado de la última llamada a CCertRequest3.Submit, CCertRequest3.RetrievePending o CCertRequest3.GetCACertificate.

Comentarios

El valor recuperado por GetLastStatus depende de la llamada más reciente a ICertRequest3::Submit, ICertRequest3::RetrievePending o ICertRequest3::GetCACertificate. Si se produce un error en una llamada a uno de estos métodos en el servidor, llame a GetLastStatus para recuperar el número de error. Algunos errores de servidor (como las solicitudes denegadas) devuelven S_OK y una disposición distinta de CR_DISP_ISSUED de la llamada al método y puede usar GetLastStatus para recuperar la causa específica del error. Si una llamada a uno de estos métodos se realiza correctamente, una llamada posterior a GetLastStatus devuelve S_OK (que es cero).

Además, la disposición de la solicitud se almacena en la base de datos de Servicios de certificados y se puede ver mediante el complemento MMC de la entidad de certificación (elija la columna Eliminación de solicitudes).

Ejemplos

HRESULT    hrServer, hr;
// pCertRequest is previously instantiated
// ICertRequest object pointer.
hr = pCertRequest->GetLastStatus((LONG *) &hrServer);
if (FAILED(hr))
{
    printf("Failed GetLastStatus [%x]\n", hr);
    goto error;
}
else
{
    // Use the HRESULT value as needed...
}

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