Método ICertRequest::GetLastStatus (certcli.h)
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 |