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

Статья
08/27/2023

Функция CertEnumCRLsInStore извлекает первый или следующий контекст списка отзыва сертификатов (CRL) в хранилище сертификатов. Эта функция, используемая в цикле, может последовательно извлекать все контексты списка отзыва сертификатов в хранилище сертификатов.

Синтаксис

PCCRL_CONTEXT CertEnumCRLsInStore(
  [in] HCERTSTORE    hCertStore,
  [in] PCCRL_CONTEXT pPrevCrlContext
);

Параметры

[in] hCertStore

Дескриптор хранилища сертификатов.

[in] pPrevCrlContext

Указатель на предыдущую найденную структуру CRL_CONTEXT . Параметр pPrevCrlContext должен иметь значение NULL , чтобы получить первый список отзыва сертификатов в хранилище. Последовательные списки отзыва сертификатов перечисляются путем задания pPrevCrlContext указателя, возвращенного предыдущим вызовом функции. Эта функция освобождает CRL_CONTEXT , на которые ссылаются значения этого параметра, отличные от NULL . Перечисление пропускает все списки отзыва сертификатов, ранее удаленные CertDeleteCRLFromStore.

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

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

Если функция завершается сбоем, возвращается ЗНАЧЕНИЕ NULL. Чтобы получить дополнительные сведения об ошибке, вызовите Метод GetLastError. Ниже приведены некоторые возможные коды ошибок.

Код возврата	Описание
E_INVALIDARG	Дескриптор в параметре hCertStore отличается от дескриптора в контексте сертификата, на который указывает pPrevCrlContext.
CRYPT_E_NOT_FOUND	Список отзыва сертификатов не найден. Это происходит, если хранилище пусто или достигнуто окончание списка магазина.

Возвращаемый указатель освобождается при передаче в качестве pPrevCrlContext при последующем вызове функции. В противном случае указатель должен быть явно освобожден путем вызова CertFreeCRLContext. PPrevCrlContext, не имеющий значения NULL, всегда освобождается при передаче в эту функцию через вызов CertFreeCRLContext, даже если сама функция возвращает ошибку.

Дубликат контекста списка отзыва сертификатов, возвращаемого этой функцией, можно создать, вызвав CertDuplicateCRLContext.

Требования


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