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

Статья
03/03/2024

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

Синтаксис

PCCTL_CONTEXT CertEnumCTLsInStore(
  [in] HCERTSTORE    hCertStore,
  [in] PCCTL_CONTEXT pPrevCtlContext
);

Параметры

[in] hCertStore

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

[in] pPrevCtlContext

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

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

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

Если функция завершается сбоем и CTL не найден, возвращаемое значение равно NULL. Для получения дополнительных сведений об ошибке вызовите Метод GetLastError.

Ниже приведены некоторые возможные коды ошибок.

Код возврата	Описание
CRYPT_E_NOT_FOUND	Либо в хранилище отсутствуют списки CCL, либо функция достигла конца списка хранилища.
E_INVALIDARG	Дескриптор в параметре hCertStore отличается от дескриптора в контексте CTL, на который указывает параметр pPrevCtlContext .

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

Дубликат можно создать, вызвав CertDuplicateCTLContext.

Требования

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