estrutura CERT_SELECT_CRITERIA (wincrypt.h)
A estrutura CERT_SELECT_CRITERIA especifica os critérios de seleção que são passados para a função CertSelectCertificateChains .
Sintaxe
typedef struct _CERT_SELECT_CRITERIA {
DWORD dwType;
DWORD cPara;
void **ppPara;
} CERT_SELECT_CRITERIA, *PCERT_SELECT_CRITERIA;
Membros
dwType
Especifica o tipo de critérios de seleção usados para o membro ppPara . Esse membro pode ter um dos valores a seguir.
| Valor | Significado |
|---|---|
|
Selecione certificados com base em um uso de chave aprimorado específico. Quando esse sinalizador é definido, o ppPara deve referenciar uma cadeia de caracteres ANSI do OID ( identificador de objeto terminada em nulo) que especifique o uso avançado da chave.
Esses critérios são avaliados no certificado. |
|
Selecione certificados com base em uma extensão de szOID_KEY_USAGE específica no certificado. Quando esse sinalizador é definido, o membro ppPara deve referenciar uma estrutura CERT_EXTENSION em que o valor da extensão é um DWORD que identifica os bits de Uso da Chave.
Esses critérios são avaliados no certificado. |
|
Selecione certificados com base em uma política de emissão específica. O membro ppPara deve referenciar uma cadeia de caracteres ANSI OID terminada em nulo da política de emissão desejada.
Esses critérios são avaliados na política de emissão da cadeia de certificados. |
|
Selecione certificados com base em um provedor de chave privada específico. O membro ppPara deve referenciar uma cadeia de caracteres Unicode terminada em nulo que represente o nome do provedor. |
|
Selecione certificados com base na presença de uma extensão especificada e em um valor opcional especificado. O membro ppPara deve referenciar uma estrutura CERT_EXTENSION que especifica a extensão OID e o valor associado. |
|
Selecione certificados com base no Nome do HOST DNS da Entidade. O membro ppPara deve referenciar uma cadeia de caracteres Unicode terminada em nulo que contenha o nome do host da entidade. A seleção executada com base nesse sinalizador é a mesma que a avaliação do membro pwszServerName da estrutura SSL_EXTRA_CERT_CHAIN_POLICY_PARA durante uma chamada para a função CertVerifyCertificateChainPolicy .
Esses critérios são avaliados no certificado. |
|
Selecione certificados com base no elemento RDN ( nome diferenciado relativo ) do emissor do certificado. O membro ppPara deve referenciar uma estrutura CERT_RDN que contenha o elemento RDN do emissor.
Esses critérios são avaliados na cadeia de certificados. |
|
Selecione certificados com base no elemento RDN na Entidade do certificado. O membro ppPara deve ser uma referência a uma estrutura CERT_RDN que contém o elemento RDN do Subject.
Esses critérios são avaliados no certificado. |
|
Selecione certificados com base no emissor do certificado. O membro ppPara deve ser uma referência a uma estrutura CERT_NAME_BLOB que contém o nome do emissor.
Esses critérios são avaliados na cadeia de certificados. |
|
Selecione certificados com base na chave pública do certificado. O membro ppPara deve referenciar um ponteiro para uma estrutura CERT_PUBLIC_KEY_INFO que contém a chave pública.
Esses critérios são avaliados no certificado. |
|
Selecione certificados com base no requisito de assinatura do protocolo TLS. O membro ppPara deve referenciar uma estrutura SecPkgContext_SupportedSignatures .
Esses critérios são avaliados no certificado. |
cPara
Um valor DWORD que especifica o número de atributos de pesquisa especificados no membro ppPara .
ppPara
Um ponteiro para um ponteiro para um ou mais valores de seleção. O tipo de dados depende do tipo de seleção especificado pelo membro dwType . Se mais de um valor de seleção estiver presente, um aplicativo deverá corresponder apenas a um valor.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 7 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 R2 [somente aplicativos da área de trabalho] |
| Cabeçalho | wincrypt.h |