Compartilhar via


Exibindo o banco de dados dos Serviços de Certificados

A interface ICertView é usada por clientes autorizados corretamente para exibir o banco de dados dos Serviços de Certificados. Deve-se observar que, como parte do produto enviado, o snap-in MMC da Autoridade de Certificação pode ser usado para exibir o banco de dados dos Serviços de Certificados. ICertView é fornecido para exibir programaticamente o banco de dados. O suporte para a interface ICertView começa com o Windows XP.

Um cliente devidamente autorizado significa um usuário que recebeu permissão para exibir o banco de dados dos Serviços de Certificados; O snap-in MMC da Autoridade de Certificação pode ser usado para conceder ou restringir o acesso para exibir o banco de dados (em Propriedades para a autoridade de certificação, clique na guia Segurança ). Além disso, para usar o objeto ICertView , é necessário que a estação de trabalho do cliente tenha instalado os componentes cliente dos Serviços de Certificados.

Embora haja vários cenários para usar ICertView e suas interfaces relacionadas, o seguinte ilustra uma possível sequência para desenvolver um aplicativo cliente com base em ICertView:

Para exibir o banco de dados dos Serviços de Certificados

  1. Depois de obter uma instância do objeto ICertView , chame ICertView::OpenConnection para se comunicar com uma autoridade de certificação em um computador específico.
  2. Chame ICertView::SetResultColumnCount para especificar o número de colunas na exibição; essa chamada também é usada para especificar uma exibição padrão. Se uma exibição padrão não for especificada na chamada, o chamador deverá chamar ICertView::SetResultColumn para cada uma das colunas a serem contidas na exibição.
  3. Opcional. Especifique critérios de classificação e/ou critérios de qualificação para a consulta de banco de dados chamando a função ICertView::SetRestriction . Critérios de qualificação consistem em informar a exibição para recuperar dados com base em qualificadores como Maior que, Menor que, Igual a e assim por diante.
  4. Chame ICertView::OpenView para recuperar os dados na exibição; os dados da exibição consistirão nas colunas solicitadas por meio de ICertView::SetResultColumnCount (e se uma exibição padrão não tiver sido especificada, ICertView::SetResultColumn). Se ICertView::SetRestriction tiver sido chamado, os dados nas colunas serão classificados e/ou qualificados. ICertView::OpenView cria um objeto IEnumCERTVIEWROW , que pode ser usado para enumerar as linhas da exibição.
  5. Use os métodos IEnumCERTVIEWROWIEnumCERTVIEWROW::EnumCertViewAttribute, IEnumCERTVIEWROW::EnumCertViewColumn e IEnumCERTVIEWROW::EnumCertViewExtension para recuperar dados de atributo, coluna e extensão conforme desejado.