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


Функция CertFindSubjectInSortedCTL (wincrypt.h)

Функция CertFindSubjectInSortedCTL пытается найти указанную тему в отсортированном списке доверия сертификатов (CTL). Субъект можно определить по всему контексту сертификата или по любому уникальному идентификатору субъекта сертификата, например хэшу SHA1 издателя сертификата и серийному номеру.

Синтаксис

BOOL CertFindSubjectInSortedCTL(
  [in]  PCRYPT_DATA_BLOB pSubjectIdentifier,
  [in]  PCCTL_CONTEXT    pCtlContext,
  [in]  DWORD            dwFlags,
  [in]  void             *pvReserved,
  [out] PCRYPT_DER_BLOB  pEncodedAttributes
);

Параметры

[in] pSubjectIdentifier

Указатель на структуру CRYPT_DATA_BLOB , однозначно идентифицируя субъект. Сведения в этой структуре могут быть хэшом или любой уникальной последовательностью байтов.

[in] pCtlContext

Указатель на структуру CTL_CONTEXT для поиска.

[in] dwFlags

Зарезервировано для использования в будущем и должно иметь значение NULL.

[in] pvReserved

Зарезервировано для использования в будущем и должно иметь значение NULL.

[out] pEncodedAttributes

Указатель на структуру CRYPT_DER_BLOB , содержащую число байтов и указатель на закодированные атрибуты субъекта.

Возвращаемое значение

Если функция выполняется успешно и идентификатор субъекта существует в CTL, возвращаемое значение равно TRUE.

Если функция завершается сбоем и не находит соответствующий идентификатор субъекта, возвращается значение FALSE.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header wincrypt.h
Библиотека Crypt32.lib
DLL Crypt32.dll

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

CTL_CONTEXT

CertEnumSubjectInSortedCTL

Функции обслуживания хранилища сертификатов и сертификатов