Exibindo o banco de dados de serviços de certificados
A interface ICertView é usada por clientes devidamente autorizados para exibir o banco de dados de 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 visualização programática do 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 os componentes do cliente dos Serviços de Certificados instalados.
Embora existam vários cenários para usar ICertView e suas interfaces relacionadas, o seguinte descreve uma sequência possível para desenvolver um aplicativo cliente com base em ICertView:
Para exibir o banco de dados dos Serviços de Certificados
- 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.
- Chame ICertView::SetResultColumnCount para especificar o número de colunas na exibição; Essa chamada também é usada para especificar um modo de exibição padrão. Se um modo de exibição padrão não for especificado na chamada, o chamador deverá chamar ICertView::SetResultColumn para cada uma das colunas a serem contidas no modo de exibição.
- Opcional. Especifique critérios de classificação e/ou critérios de qualificação para a consulta de banco de dados chamando a funçãoICertView::SetRestriction . Os critérios de qualificação consistem em definir os parâmetros para obter dados com base em qualificadores como maior que, menor que, igual a e assim por diante.
- 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 foi especificada, ICertView::SetResultColumn). Se ICertView::SetRestriction foi chamado, os dados nas colunas serão ordenados e/ou qualificados. ICertView::OpenView cria um IEnumCERTVIEWROW objeto, que pode ser usado para enumerar as linhas da vista.
- Use os métodos IEnumCERTVIEWROWIEnumCERTVIEWROW::EnumCertViewAttribute, IEnumCERTVIEWROW::EnumCertViewColumne IEnumCERTVIEWROW::EnumCertViewExtension para recuperar dados de atributo, coluna e extensão conforme desejado.