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

  • Artigo

O método Enroll registra uma solicitação de certificado e recupera o certificado emitido. Esse método está habilitado para a Web.

Sintaxe

HRESULT Enroll(
  [in]          BSTR               strEnrollmentPolicyServerURI,
  [in]          BSTR               strTemplateName,
  [in]          EncodingType       Encoding,
  [in]          WebEnrollmentFlags enrollFlags,
  [out, retval] BSTR               *pstrCertificate
);

Parâmetros

[in] strEnrollmentPolicyServerURI

Um BSTR que contém a URL do servidor de política de registro de certificado.

[in] strTemplateName

Uma variável BSTR que contém o CN (Nome Comum) do modelo como ele aparece no Active Directory ou no identificador de objeto decimal pontilhado.

[in] Encoding

Um valor de enumeração EncodingType que especifica o tipo de codificação aplicado a uma matriz de bytes para fins de exibição.

[in] enrollFlags

Um valor de enumeração WebEnrollmentFlags que especifica o comportamento de registro na Web. Esse pode ser o valor a seguir.

Valor Significado
EnrollPrompt
 Se esse sinalizador estiver definido e nenhuma credencial de autenticação estiver disponível para o servidor de registro de certificado, o serviço de certificado solicitará uma credencial. Se não houver nenhuma credencial de autenticação e esse sinalizador não estiver definido, o método Enroll falhará.

[out, retval] pstrCertificate

Um BSTR que contém o certificado emitido.

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.

Código de retorno Descrição
E_INVALIDARG
 Os parâmetros strEnrollmentPolicyServerURI e strTemplateName não podem ser NULL.
HRESULT_FROM_WIN32(ERROR_ARITHMETIC_OVERFLOW)
 Os parâmetros strEnrollmentPolicyServerURI e strTemplateName excedem 64.000 caracteres ou contêm caracteres nulos inseridos.

Comentários

O método Enroll recupera o modelo apropriado, chama InitializeFromTemplate e chama Enroll no objeto IX509Enrollment .

Esse método não instala o certificado emitido.

Requisitos

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

Confira também

IX509EnrollmentHelper