Compartilhar via


Interface IX509Enrollment (certenroll.h)

A interface IX509Enrollment representa o objeto de nível superior e permite que você se registre em uma hierarquia de certificados e instale uma resposta de certificado. O processo de registro dá suporte aos três cenários a seguir:

Registro fora de banda
  1. Chame qualquer método de inicialização implementado pelo objeto IX509Enrollment .
  2. Chame o método CreateRequest .
  3. Envie a solicitação fora da banda (manualmente ou por meio de algum outro processo).
  4. Receba a resposta de uma autoridade de certificação ou registro.
  5. Chame o método InstallResponse .
Registro automático
  1. Chame qualquer método de inicialização implementado pelo objeto IX509Enrollment .
  2. Chame o método Enroll .
Registro atrasado
  1. Chame qualquer método de inicialização implementado pelo objeto IX509Enrollment .
  2. Chame o método CreateRequest .
  3. Armazene a solicitação por um período de tempo, como dias ou semanas.
  4. Chame o método Initialize para criar um objeto de solicitação quando você estiver pronto para registrar.
  5. Preencha o objeto de solicitação da solicitação armazenada.
  6. Chame o método InstallResponse .

Herança

A interface IX509Enrollment herda da interface IDispatch . O IX509Enrollment também tem estes tipos de membros:

Métodos

A interface IX509Enrollment tem esses métodos.

 
IX509Enrollment::CreatePFX

Cria uma mensagem PFX (Troca de Informações Pessoais).
IX509Enrollment::CreateRequest

Recupera uma solicitação de certificado codificada.
IX509Enrollment::Enroll

Codifica uma solicitação, envia-a a uma AC (autoridade de certificação) apropriada e instala a resposta.
IX509Enrollment::get_CAConfigString

Recupera a cadeia de caracteres de configuração que identifica a AC (autoridade de certificação) à qual a solicitação de certificado foi enviada.
IX509Enrollment::get_Certificate

Recupera o certificado instalado.
IX509Enrollment::get_CertificateDescription

Especifica ou recupera uma cadeia de caracteres que contém uma descrição do certificado. (Obter)
IX509Enrollment::get_CertificateFriendlyName

Especifica ou recupera o nome de exibição de um certificado. (Obter)
IX509Enrollment::get_EnrollmentContext

Recupera um contexto de registro que identifica se o certificado se destina a um computador ou um usuário final.
IX509Enrollment::get_NameValuePairs

Recupera uma coleção de pares nome-valor associados ao objeto de registro.
IX509Enrollment::get_ParentWindow

Especifica ou recupera a ID da janela usada para exibir as informações de registro. (Obter)
IX509Enrollment::get_Request

Recupera a solicitação de certificado associada ao objeto de registro.
IX509Enrollment::get_RequestId

Recupera um identificador exclusivo para a solicitação de certificado enviada à autoridade de certificação pelo método Enroll.
IX509Enrollment::get_Response

Recupera a resposta do certificado retornada de uma autoridade de certificação.
IX509Enrollment::get_Silent

Especifica ou recupera um valor booliano que indica se uma interface do usuário é exibida durante o processo de registro de certificado. (Obter)
IX509Enrollment::get_Status

Recupera um objeto IX509EnrollmentStatus que pode ser usado para monitorar a status do processo de registro e recuperar informações de erro.
IX509Enrollment::Initialize

Inicializa o objeto de registro e cria um PKCS padrão
IX509Enrollment::InitializeFromRequest

Inicializa o objeto de registro de um objeto IX509CertificateRequest existente.
IX509Enrollment::InitializeFromTemplateName

Inicializa o objeto de registro de um CN (nome comum) de modelo.
IX509Enrollment::InstallResponse

Instala uma cadeia de certificados no computador de entidade final. (IX509Enrollment.InstallResponse)
IX509Enrollment::p ut_CertificateDescription

Especifica ou recupera uma cadeia de caracteres que contém uma descrição do certificado. (Put)
IX509Enrollment::p ut_CertificateFriendlyName

Especifica ou recupera o nome de exibição de um certificado. (Put)
IX509Enrollment::p ut_ParentWindow

Especifica ou recupera a ID da janela usada para exibir as informações de registro. (Put)
IX509Enrollment::p ut_Silent

Especifica ou recupera um valor booliano que indica se uma interface do usuário é exibida durante o processo de registro de certificado. (Put)

Requisitos

   
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

Confira também

API de registro de certificado

IDispatch

IX509EnrollmentStatus