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

  • Artigo

O método InitializeFromTemplateName inicializa o objeto de registro de um CN (nome comum) de modelo.

Sintaxe

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

Parâmetros

[in] Context

Um valor de enumeração X509CertificateEnrollmentContext que indica se o registro solicitado é para um usuário, um computador ou um administrador que atua em nome de um computador.

[in] strTemplateName

Uma variável BSTR que contém o NOME Comum (CN) 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
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 O objeto de registro já foi inicializado.

Comentários

O método InitializeFromTemplateName :

  • Examina o modelo para determinar o tipo de solicitação necessária.
  • Cria o tipo apropriado de objeto de solicitação (PKCS #10, PKCS #7 ou CMC).
  • Define as seguintes propriedades na solicitação se os valores existirem no momento:
  • Inicializa o objeto de solicitação usando o modelo .
  • Recupera a contagem de assinaturas, as políticas de emissão e as políticas de aplicativo do modelo.

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