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

Consulte también

CERT_INFO

CRYPT_INTEGER_BLOB

CTL_FIND_SUBJECT_PARA

CTL_USAGE

CertFindCTLInStore