Compartilhar via


Método IX509Enrollment::Enroll (certenroll.h)

O método Enroll codifica uma solicitação, envia-a a uma AC (autoridade de certificação) apropriada e instala a resposta.

Sintaxe

HRESULT Enroll();

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
OLE_E_BLANK
O objeto de registro não foi inicializado.

Comentários

O método pode criar um par de chaves, se necessário. Dependendo de como você inicializa o objeto de registro e em quais propriedades você definiu, talvez não haja necessidade de criar um par de chaves. Por exemplo, se você estiver renovando um certificado usando uma chave existente ou se o objeto IX509PrivateKey associado à solicitação de certificado representar uma chave existente, esse método não criará um novo par de chaves.

Antes de se registrar, você deve inicializar o objeto IX509Enrollment chamando um dos métodos a seguir.

Se a operação de registro for bem-sucedida, a função retornará S_OK. No entanto, isso não significa necessariamente que a resposta da AC foi instalada. Chame a propriedade Status para determinar o registro status.

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

Confira também

IX509Enrollment