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

  • Статья

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

Синтаксис

BOOL WINAPI CertStoreProvFindCert(
  _In_    HCERTSTOREPROV              hStoreProv,
  _In_    PCCERT_STORE_PROV_FIND_INFO pFindInfo,
  _In_    PCCERT_CONTEXT              pPrevCertContext,
  _In_    DWORD                       dwFlags,
  _Inout_ void                        **ppvStoreProvFindInfo,
  _Out_   PCCERT_CONTEXT              *ppProvCertContext
);

Параметры

hStoreProv [in]

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

pFindInfo [in]

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

pPrevCertContext [in]

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

dwFlags [in]

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

ppvStoreProvFindInfo [in, out]

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

ppProvCertContext [out]

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

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

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

Требования

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

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

CERT_CONTEXT

CERT_STORE_PROV_FIND_INFO

CertFindCertificateInStore