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