Функция CertEnumSubjectInSortedCTL (wincrypt.h)
Функция 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 |