struttura CTL_FIND_USAGE_PARA (wincrypt.h)

Articolo
08/27/2023

La struttura CTL_FIND_USAGE_PARA è un membro della struttura CTL_FIND_SUBJECT_PARA e viene usata da CertFindCTLInStore.

Sintassi

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;

Members

cbSize

Dimensione, in byte, della struttura.

SubjectUsage

CTL_USAGE struttura che include una sequenza di identificatori di oggetto da trovare quando si trova un elenco di certificati attendibili (CTL).

Un CTL trovato deve contenere tutti gli identificatori di oggetto di utilizzo specificati dal membro SubjectUsage .

Se il membro cUsageIdentifier di questa struttura è zero, un CTL con qualsiasi utilizzo può essere una corrispondenza.

ListIdentifier

Specificato per limitare una ricerca a un elenco CTL del firmatario specifico. In genere, il membro ListIdentifier sarà zero, a indicare che qualsiasi ListIdentifier può essere corrispondente. Se non è zero, listIdentifier e ListIdentifier in una durata (CTL) devono corrispondere.

Per trovare la corrispondenza solo con elenchi consentiti senza ListIdentifier , il membro cbData di ListIdentifier è impostato su CTL_FIND_NO_LIST_ID_CBDATA.

Un CTL usa un ListIdentifier per distinguere tra più CTL create dallo stesso emittente con lo stesso OggettoUsage.

pSigner

Puntatore a una struttura CERT_INFO che specifica il firmatario CTL da associare. Solo l'emittente e il numero di serie del CERT_INFO vengono usati per trovare la corrispondenza con un firmatario.

Impostare pSigner su NULL in modo che corrisponda a qualsiasi firmatario. Per trovare la corrispondenza con le licenze CRL che non dispongono di alcun firmatario, impostare pSigner su CTL_FIND_NO_SIGNER_PTR.

Il valore CertEncodingType del firmatario viene ottenuto dal parametro dwMsgAndCertEncodingType di CertFindCTLInStore.