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

Artigo
03/14/2023

O método GetLastStatus obtém o último código de retorno para essa solicitação. Isso retorna as informações de código de erro, em vez da disposição da solicitação.

Sintaxe

HRESULT GetLastStatus(
  [out] LONG *pStatus
);

Parâmetros

[out] pStatus

Um ponteiro para o código de status da solicitação.

Retornar valor

C++

Se o método for bem-sucedido, o método retornará S_OK.

Após a conclusão bem-sucedida dessa função, *pStatus é definido como o código de resultado da chamada mais recente para ICertRequest3::Submit, ICertRequest3::RetrievePending ou ICertRequest3::GetCACertificate.

Se o método falhar, ele retornará um valor HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

VB

O valor retornado é o código de resultado da chamada mais recente para CCertRequest3.Submit, CCertRequest3.RetrievePending ou CCertRequest3.GetCACertificate.

Comentários

O valor recuperado por GetLastStatus depende da chamada mais recente para ICertRequest3::Submit, ICertRequest3::RetrievePending ou ICertRequest3::GetCACertificate. Se uma chamada para um desses métodos falhar no servidor, chame GetLastStatus para recuperar o número de erro. Algumas falhas de servidor (como solicitações negadas) retornam S_OK e uma disposição diferente de CR_DISP_ISSUED da chamada de método, e você pode usar GetLastStatus para recuperar a causa específica da falha. Se uma chamada para um desses métodos for bem-sucedida, uma chamada subsequente para GetLastStatus retornará S_OK (que é zero).

Além disso, a disposição da solicitação é armazenada no banco de dados dos Serviços de Certificados e pode ser exibida por meio do snap-in MMC da Autoridade de Certificação (escolha a coluna Solicitar Disposição).

Exemplos

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	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	certcli.h (inclua Certsrv.h)
Biblioteca	Certidl.lib
DLL	Certcli.dll