Функция обратного вызова CertStoreProvFindCTL

  • Статья

Функция обратного вызова CertStoreProvFindCTL перечисляет или находит первый или следующий CTL во внешнем хранилище , соответствующем указанным условиям.

Синтаксис

BOOL WINAPI CertStoreProvFindCTL(
  _In_    HCERTSTOREPROV              hStoreProv,
  _In_    PCCERT_STORE_PROV_FIND_INFO pFindInfo,
  _In_    PCCTL_CONTEXT               pPrevCtlContext,
  _In_    DWORD                       dwFlags,
  _Inout_ void                        **ppvStoreProvFindInfo,
  _Out_   PCCTL_CONTEXT               *ppProvCtlContext
);

Параметры

hStoreProv [in]

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

pFindInfo [in]

Указатель на структуру CERT_STORE_PROV_FIND_INFO , содержащую все параметры, передаваемые в CertFindCTLInStore. .

pPrevCtlContext [in]

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

dwFlags [in]

Все необходимые значения флагов.

ppvStoreProvFindInfo [in, out]

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

ppProvCtlContext [out]

При успешном поиске в этом параметре возвращается указатель на найденный список CTL.

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

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

Требования

Требование Значение
Минимальная версия клиента
 Windows XP [только классические приложения]
Минимальная версия сервера
 Windows Server 2003 [только классические приложения]

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

CERT_STORE_PROV_FIND_INFO

CertFindCTLInStore

CTL_CONTEXT