Método ICertificates2::Find
[CAPICOM é um componente somente de 32 bits disponível para uso nos seguintes sistemas operacionais: Windows Server 2008, Windows Vista e Windows XP. Em vez disso, use a classe X509Certificate2Collection no namespace System.Security.Cryptography.X509Certificates .]
O método Find retorna um objeto Certificates que contém todos os certificados que correspondem aos critérios de pesquisa especificados. Esse método foi introduzido no CAPICOM 2.0.
Sintaxe
Certificates.Find( _
ByVal FindType, _
[ ByVal varCriteria ], _
[ ByVal bFindValidOnly ] _
)
Parâmetros
-
FindType [in]
-
Um valor da enumeração CAPICOM_CERTIFICATE_FIND_TYPE que especifica o tipo de critério de correspondência fornecido no parâmetro varCriteria . A tabela a seguir mostra os valores possíveis.
Valor Significado - CAPICOM_CERTIFICATE_FIND_SHA1_HASH
Retorna certificados com um hash SHA1 que corresponde ao hash SHA1 especificado no parâmetro varCriteria . - CAPICOM_CERTIFICATE_FIND_SUBJECT_NAME
Retorna certificados cujo nome da entidade corresponde exatamente ou parcialmente ao nome da entidade especificado no parâmetro varCriteria . Essa chamada pesquisa apenas o campo nome da entidade. - CAPICOM_CERTIFICATE_FIND_ISSUER_NAME
Retorna certificados cujo nome do emissor corresponde exatamente ou parcialmente ao nome do emissor especificado no parâmetro varCriteria . Essa chamada pesquisa apenas o campo nome do emissor. - CAPICOM_CERTIFICATE_FIND_ROOT_NAME
Retorna certificados cujo nome de entidade raiz corresponde exatamente ou parcialmente ao nome da entidade raiz especificado no parâmetro varCriteria . Essa chamada cria uma cadeia. Essa chamada pesquisa o campo nome da entidade do certificado raiz. - CAPICOM_CERTIFICATE_FIND_TEMPLATE_NAME
Retorna certificados cujo nome de modelo corresponde ao nome do modelo especificado no parâmetro varCriteria . - CAPICOM_CERTIFICATE_FIND_EXTENSION
Retorna certificados que têm uma extensão que corresponde à extensão especificada no parâmetro varCriteria . - CAPICOM_CERTIFICATE_FIND_EXTENDED_PROPERTY
Retorna certificados no repositório que contêm explicitamente uma propriedade estendida com o valor especificado no parâmetro varCriteria . - CAPICOM_CERTIFICATE_FIND_APPLICATION_POLICY
Retorna certificados no repositório que têm uma extensão de uso de chave aprimorada, uma extensão de política de aplicativo ou uma propriedade estendida especificada no parâmetro varCriteria . - CAPICOM_CERTIFICATE_FIND_CERTIFICATE_POLICY
Retorna certificados que contêm o OID de política na extensão de Política de Certificado especificada no parâmetro varCriteria . - CAPICOM_CERTIFICATE_FIND_TIME_VALID
Retorna certificados cujo tempo é válido. - CAPICOM_CERTIFICATE_FIND_TIME_NOT_YET_VALID
Retorna certificados cujo tempo ainda não é válido. - CAPICOM_CERTIFICATE_FIND_TIME_EXPIRED
Retorna certificados cujo tempo expirou. - CAPICOM_CERTIFICATE_FIND_KEY_USAGE
Retorna certificados que contêm usos de chave na extensão KeyUsage especificada no parâmetro varCriteria . Se a extensão KeyUsage não estiver presente, todos os usos de chave serão considerados indisponíveis. -
varCriteria [in, opcional]
-
Uma variante que contém os critérios de pesquisa. Esses dados devem corresponder ao tipo de dados especificado no parâmetro FindType . Se o valor do parâmetro FindType for CAPICOM_CERTIFICATE_FIND_TIME_VALID, CAPICOM_CERTIFICATE_FIND_TIME_NOT_YET_VALID ou CAPICOM_CERTIFICATE_FIND_TIME_EXPIRED e você não passar um valor para esse parâmetro, a hora atual será assumida. Para obter exemplos de cada tipo de dados, consulte Comentários. O valor padrão é 0.
-
bFindValidOnly [in, opcional]
-
Um valor booliano que indica se apenas os certificados válidos são retornados. O valor padrão é falso; isso indica que todos os certificados que correspondem aos critérios de pesquisa são retornados.
Se for true, a pesquisa não retornará os seguintes tipos de certificados:
- Certificados cujo tempo expirou ou ainda não é válido.
- Certificados não encadeados corretamente.
- Certificados que têm problemas de assinatura.
- Certificados revogados.
Valor retornado
Objeto Certificates que contém os resultados da pesquisa.
CAPICOM 2.1: O objeto Certificates retornado contém referências aos certificados na coleção na qual a pesquisa foi feita. Todas as alterações feitas nos certificados no objeto Certificates retornado são refletidas nessa coleção.
CAPICOM 2.0, CAPICOM 2.0.0.1, CAPICOM 2.0.0.2 e CAPICOM 2.0.0.3: O objeto Certificates retornado contém cópias dos certificados na coleção na qual a pesquisa foi feita. As alterações feitas nos certificados no objeto Certificates retornado não são refletidas nessa coleção.
Comentários
Os exemplos a seguir mostram possíveis critérios de pesquisa para os diferentes tipos de critérios de pesquisa.
Parâmetro FindType | parâmetro varCriteria |
---|---|
CAPICOM_CERTIFICATE_FIND_SHA1_HASH | 33F362434B577F844BB7226BE36F7D72EF9D9393 |
CAPICOM_CERTIFICATE_FIND_SUBJECT_NAME | "NameOfPerson" |
CAPICOM_CERTIFICATE_FIND_ISSUER_NAME | "VeriSign" |
CAPICOM_CERTIFICATE_FIND_ROOT_NAME | "Microsoft Root Authority" |
CAPICOM_CERTIFICATE_FIND_TEMPLATE_NAME | "AutoEnrollEFS" 1.3.6.1.4.1.311.21.8.3692315854.1256661383.1690418588.4201632533.1741915387.2177932052 |
CAPICOM_CERTIFICATE_FIND_EXTENSION | "2.5.29.31" CAPICOM_OID_KEY_USAGE_EXTENSION "Lista de Distribuição de CRL" |
CAPICOM_CERTIFICATE_FIND_EXTENDED_PROPERTY | CAPICOM_PROPID_KEY_PROV_INFO |
CAPICOM_CERTIFICATE_FIND_APPLICATION_POLICY | "1.3.6.1.5.5.7.3.3" "1.3.6.1.5.5.7.3.4" CAPICOM_OID_SERVER_AUTH_EKU "Assinatura de código" |
CAPICOM_CERTIFICATE_FIND_CERTIFICATE_POLICY | "1.3.6.1.5.5.7.3.4.3.5" "Alta Garantia Corporativa" |
CAPICOM_CERTIFICATE_FIND_TIME_VALID | Nº 15/04/2002, 18h # |
CAPICOM_CERTIFICATE_FIND_TIME_NOT_YET_VALID | Nº 15/04/2002, 18h # |
CAPICOM_CERTIFICATE_FIND_TIME_EXPIRED | Nº 15/04/2002, 18h # |
CAPICOM_CERTIFICATE_FIND_KEY_USAGE | CAPICOM_ENCIPHER_ONLY_KEY_USAGE |
Requisitos
Requisito | Valor |
---|---|
Fim do suporte ao cliente |
Windows Vista |
Fim do suporte ao servidor |
Windows Server 2008 |
Redistribuível |
CAPICOM 2.0 ou posterior no Windows Server 2003 e Windows XP |
DLL |
|
Confira também