Compartilhar via


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
CERT_SELECT_BY_ENHKEY_USAGE
1
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.

CERT_SELECT_BY_KEY_USAGE
2
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.

CERT_SELECT_BY_POLICY_OID
3
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.

CERT_SELECT_BY_PROV_NAME
4
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.
CERT_SELECT_BY_EXTENSION
5
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.
CERT_SELECT_BY_SUBJECT_HOST_NAME
6
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.

CERT_SELECT_BY_ISSUER_ATTR
7
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.

CERT_SELECT_BY_SUBJECT_ATTR
8
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.

CERT_SELECT_BY_ISSUER_NAME
9
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.

CERT_SELECT_BY_PUBLIC_KEY
10
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.

CERT_SELECT_BY_TLS_SIGNATURES
11
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