estrutura CTL_FIND_USAGE_PARA (wincrypt.h)

A estrutura CTL_FIND_USAGE_PARA é membro da estrutura CTL_FIND_SUBJECT_PARA e é usada por CertFindCTLInStore.

Sintaxe

typedef struct _CTL_FIND_USAGE_PARA {
  DWORD           cbSize;
  CTL_USAGE       SubjectUsage;
  CRYPT_DATA_BLOB ListIdentifier;
  PCERT_INFO      pSigner;
} CTL_FIND_USAGE_PARA, *PCTL_FIND_USAGE_PARA;

Membros

cbSize

O tamanho, em bytes, dessa estrutura.

SubjectUsage

CTL_USAGE estrutura que inclui uma sequência de identificadores de objeto a serem correspondidos ao encontrar uma CTL ( lista de confiança de certificado ).

Uma CTL encontrada deve conter todos os identificadores de objeto de uso especificados pelo membro SubjectUsage .

Se o membro cUsageIdentifier dessa estrutura for zero, uma CTL com qualquer uso poderá ser uma correspondência.

ListIdentifier

Especificado para restringir uma pesquisa a uma lista ctl de signatário específica. Normalmente, o membro ListIdentifier será zero, indicando que qualquer ListIdentifier pode ser correspondido. Se não for zero, este ListIdentifier e o ListIdentifier em uma CTL deverão corresponder.

Para corresponder somente a CTLs que não têm ListIdentifier , o membro cbData de ListIdentifier está definido como CTL_FIND_NO_LIST_ID_CBDATA.

Uma CTL usa um ListIdentifier para distinguir entre várias CTLs criadas pelo mesmo emissor com o mesmo SubjectUsage.

pSigner

Um ponteiro para uma estrutura de CERT_INFO que especifica o signatário ctl a ser correspondido. Somente o emissor e o número de série do CERT_INFO são usados para corresponder a um signatário.

Defina pSigner como NULL para corresponder a qualquer signatário. Para corresponder a CTLs que não têm nenhum signatário, defina pSigner como CTL_FIND_NO_SIGNER_PTR.

O CertEncodingType do signatário é obtido do parâmetro dwMsgAndCertEncodingType de CertFindCTLInStore.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho wincrypt.h

Confira também

CERT_INFO

CRYPT_INTEGER_BLOB

CTL_FIND_SUBJECT_PARA

CTL_USAGE

CertFindCTLInStore