Функция обратного вызова 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 [только классические приложения] |
См. также раздел