Поделиться через

структура CTL_FIND_USAGE_PARA (wincrypt.h)

  • Статья

Структура CTL_FIND_USAGE_PARA является членом структуры CTL_FIND_SUBJECT_PARA и используется в CertFindCTLInStore.

Синтаксис

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;

Члены

cbSize

Размер данной структуры (в байтах).

SubjectUsage

CTL_USAGE структура, которая включает последовательность идентификаторов объектов, которые должны сопоставляться при поиске списка доверия сертификатов (CTL).

Найденный CTL должен содержать все идентификаторы объектов использования, указанные элементом SubjectUsage .

Если элемент cUsageIdentifier этой структуры равен нулю, CTL с любым использованием может быть совпадением.

ListIdentifier

Определяется для ограничения поиска определенным списком CTL подписывателя. Обычно элемент ListIdentifier будет равен нулю, что означает, что можно сопоставить любой элемент ListIdentifier . Если значение не равно нулю, эти ListIdentifier и ListIdentifier в списке CTL должны совпадать.

Чтобы сопоставить только списки CCL, у которых нет ListIdentifier , члену cbDatalistIdentifier присваивается значение CTL_FIND_NO_LIST_ID_CBDATA.

CTL использует ListIdentifier для различения нескольких списков CCL, созданных одним и тем же издателем с одним и тем же SubjectUsage.

pSigner

Указатель на структуру CERT_INFO , указывающую совпадающего подписателя CTL. Для сопоставления подписавшему объекту используются только издатель и серийный номер из CERT_INFO .

Задайте для параметра pSignerзначение NULL , чтобы соответствовать любому подписывшему. Чтобы сопоставить списки CCL, у которых нет подписывателей, задайте для pSigner значение CTL_FIND_NO_SIGNER_PTR.

CertEncodingType подписывателя получается из параметра dwMsgAndCertEncodingTypeобъекта CertFindCTLInStore.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Верхняя часть wincrypt.h

См. также раздел

CERT_INFO

CRYPT_INTEGER_BLOB

CTL_FIND_SUBJECT_PARA

CTL_USAGE

CertFindCTLInStore