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 |