estructura CTL_FIND_USAGE_PARA (wincrypt.h)
La estructura CTL_FIND_USAGE_PARA es un miembro de la estructura de CTL_FIND_SUBJECT_PARA y la usa CertFindCTLInStore.
Sintaxis
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;
Miembros
cbSize
Tamaño, en bytes, de esta estructura.
SubjectUsage
CTL_USAGE estructura que incluye una secuencia de identificadores de objeto que se van a buscar al buscar una lista de confianza de certificados (CTL).
Un CTL encontrado debe contener todos los identificadores de objeto de uso especificados por el miembro SubjectUsage .
Si el miembro cUsageIdentifier de esta estructura es cero, un CTL con cualquier uso puede ser una coincidencia.
ListIdentifier
Se especifica para restringir una búsqueda a una lista de CTL de firmante determinada. Normalmente, el miembro ListIdentifier será cero, lo que indica que cualquier ListIdentifier puede coincidir. Si no es cero, listIdentifier y ListIdentifier en un CTL deben coincidir.
Para coincidir solo con las CTL que no tienen ListIdentifier , el miembro cbData de ListIdentifier se establece en CTL_FIND_NO_LIST_ID_CBDATA.
Un CTL usa un ListIdentifier para distinguir entre varias CTL creadas por el mismo emisor con el mismo SubjectUsage.
pSigner
Puntero a una estructura de CERT_INFO que especifica el firmante de CTL que debe coincidir. Solo el emisor y el número de serie de la CERT_INFO se usan para coincidir con un firmante.
Establezca pSigner en NULL para que coincida con cualquier firmante. Para que coincida con las CTL que no tienen ningún firmante, establezca pSigner en CTL_FIND_NO_SIGNER_PTR.
CertEncodingType del firmante se obtiene del parámetro dwMsgAndCertEncodingType de CertFindCTLInStore.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
Encabezado | wincrypt.h |