Compartilhar via

Método IX509CertificateRequestCmc2::InitializeFromTemplate (certenroll.h)

  • Artigo

O método InitializeFromTemplate inicializa a solicitação de certificado usando um modelo.

Sintaxe

HRESULT InitializeFromTemplate(
  [in] X509CertificateEnrollmentContext context,
  [in] IX509EnrollmentPolicyServer      *pPolicyServer,
  [in] IX509CertificateTemplate         *pTemplate
);

Parâmetros

[in] context

Um valor do tipo de enumeração X509CertificateEnrollmentContext que especifica se o certificado solicitado destina-se a um usuário final, um computador ou administrador que atua em nome do computador. Esse pode ser um dos valores a seguir.

Valor Significado
ContextUser
 O certificado está sendo solicitado para um usuário final.
ContextMachine
 O certificado está sendo solicitado para um computador.
ContextAdministratorForceMachine
 O certificado está sendo solicitado por um administrador que atua em nome de um computador.

[in] pPolicyServer

Ponteiro para um objeto IX509EnrollmentPolicyServer que representa o servidor CEP (política de registro de certificado) que contém o modelo especificado pelo parâmetro pTemplate .

[in] pTemplate

Ponteiro para um objeto IX509CertificateTemplate que representa o modelo a ser usado durante a inicialização.

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_POINTER
 Os parâmetros pPolicyServer e pTemplate não podem ser NULL.
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 O objeto de solicitação de certificado já foi inicializado.

Comentários

O método InitializeFromTemplate cria as seguintes coleções:

Em seguida, o método examina o modelo e executa as seguintes ações:

  • Adiciona as extensões especificadas pelo modelo à coleção IX509Extensions .
  • Remove as extensões críticas padrão (XCN_OID_KEY_USAGE e XCN_OID_BASIC_CONSTRAINTS2) da coleção se o modelo indicar que elas não são críticas. As OIDs marcadas como críticas pelo modelo são adicionadas.
  • Define a propriedade SmimeCapabilities se o modelo der suporte a algoritmos simétricos.
  • Define a propriedade AlternateSignatureAlgorithm se o modelo exigir um algoritmo de assinatura discreto OID.
  • Cria um objeto IX509SignatureInformation .
  • Cria um algoritmo de hash OID se o algoritmo for especificado no modelo e o definir no objeto IX509SignatureInformation .
  • Cria um algoritmo de criptografia assimétrica OID se o algoritmo for especificado no modelo e o definir no objeto IX509SignatureInformation .
  • Preenche muitas das propriedades IX509PrivateKey das configurações do modelo.

Se a propriedade CSPInformations for NULL, o método criará uma coleção ICspInformations dos provedores instalados no computador.

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

IX509CertificateRequestCmc2