Compartilhar via


Método IX509CertificateRequestPkcs7::InitializeFromTemplateName (certenroll.h)

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

Sintaxe

HRESULT InitializeFromTemplateName(
  [in] X509CertificateEnrollmentContext Context,
  [in] BSTR                             strTemplateName
);

Parâmetros

[in] Context

Um valor de enumeração X509CertificateEnrollmentContext que especifica se o certificado solicitado destina-se a um usuário final, um computador ou um administrador agindo em nome do computador.

[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.

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
ERROR_ALREADY_INITIALIZED
O objeto de solicitação de certificado já foi inicializado.

Comentários

O método InitializeFromTemplateName cria um objeto de solicitação PKCS nº 7 e define as seguintes propriedades para os valores que existiam antes desse método ser chamado:

O método cria as seguintes coleções:
  • Uma coleção ICryptAttributes .
  • Uma coleção IX509Extensions .
  • Uma coleção IObjectIds preenchida com os identificadores de objeto XCN_OID_KEY_USAGE e XCN_OID_BASIC_CONSTRAINTS2 padrão.
  • Uma coleção IObjectIds vazia para OIDs de atributo e extensão a serem suprimidas da nova solicitação.

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

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

Por fim, o método define a solicitação PKCS nº 10 inicializada como o objeto de solicitação interna.

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

IX509CertificateRequestPkcs7