Método IX509CertificateRequest::ResetForEncode (certenroll.h)

Artigo
08/22/2023

O método ResetForEncode restaura o estado do objeto de solicitação para o que existia antes do método Encode ser chamado.

Sintaxe

HRESULT ResetForEncode();

Retornar valor

Se a função for bem-sucedida, a função retornará S_OK.

Se a função falhar, ela retornará um valor HRESULT que indica o erro. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Valor/código retornado	Descrição
CERTSRV_E_PROPERTY_EMPTY	Extensões e atributos de certificado não foram definidos.
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)	O objeto de solicitação não está codificado.
OLE_E_BLANK	O objeto não é inicializado.

Comentários

Você pode usar esse método para reconfigurar (recodificar e assinar novamente) uma solicitação de certificado em resposta à rejeição da solicitação por uma autoridade de certificação. A assinatura e os dados brutos são limpos. As extensões e os atributos são redefinidos para os valores que tinham antes do método Encode ser chamado, mas os sinalizadores de extensão críticos não são. Para um objeto de solicitação CMC, cada solicitação aninhada também é redefinida.

Esse método normalmente é usado para uma solicitação de arquivamento de chave CMC quando a chave privada é criptografada e incluída na solicitação.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	certenroll.h
DLL	CertEnroll.dll