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

Статья
08/27/2023

Функция CertEnumSubjectInSortedCTL извлекает первый или следующий TrustedSubject в отсортированный список доверия сертификатов (CTL). Отсортированный CTL — это CTL, созданный с набором CERT_CREATE_CONTEXT_SORTED_FLAG. Эта функция, используемая в цикле, может последовательно извлекать все объекты TrustedSubject в отсортированных CTL.

Синтаксис

BOOL CertEnumSubjectInSortedCTL(
  [in]      PCCTL_CONTEXT   pCtlContext,
  [in, out] void            **ppvNextSubject,
  [out]     PCRYPT_DER_BLOB pSubjectIdentifier,
  [out]     PCRYPT_DER_BLOB pEncodedAttributes
);

Параметры

[in] pCtlContext

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

[in, out] ppvNextSubject

Указатель на адрес последнего найденного объекта TrustedSubject. Чтобы начать перечисление, ppvNextSubject должен указывать на указатель со значением NULL. После возврата указатель, адресуемый ppvNextSubject , обновляется, чтобы он указывал на следующий объект TrustedSubject в закодированной последовательности.

[out] pSubjectIdentifier

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

[out] pEncodedAttributes

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

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

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

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

Члены pbDataCRYPT_DER_BLOB структур указывают непосредственно на закодированные байты. Сами CRYPT_DER_BLOB структуры должны быть выделены и освобождены приложением, но память, адресуемая членами pbData этих структур, не выделяется приложением и не должна освобождаться приложением.

Если CTL не отсортирован с установленным флагом CERT_CREATE_CONTEXT_SORTED_FLAG, возникает ошибка.

Требования


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

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

CTL_CONTEXT

CertFindSubjectInSortedCTL

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

Share via