Función de devolución de llamada CertStoreProvFindCert
La función de devolución de llamada CertStoreProvFindCert enumera o busca el primer o siguiente certificado en un almacén externo que coincida con los criterios especificados.
Sintaxis
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
);
Parámetros
-
hStoreProv [in]
-
Controlador HCERTSTOREPROV en un almacén de certificados.
-
pFindInfo [in]
-
Puntero a una estructura de CERT_STORE_PROV_FIND_INFO que contiene todos los parámetros pasados a la función CertFindCertificateInStore .
-
pPrevCertContext [in]
-
Puntero a un CERT_CONTEXT del certificado encontrado. En la primera llamada a la función, este parámetro debe establecerse en NULL. En las llamadas posteriores, se debe establecer en el puntero devuelto en el parámetro ppProvCertContext en la última llamada. La función de devolución de llamada libera un puntero que no es NULL pasado en este parámetro.
-
dwFlags [in]
-
Cualquier valor de marca necesario.
-
ppvStoreProvFindInfo [in, out]
-
Puntero a un puntero a un búfer para devolver la información del proveedor del almacén. Opcionalmente, la devolución de llamada puede devolver un puntero a la información de búsqueda interna de este parámetro. Después de la primera llamada, este parámetro se establece en el puntero devuelto por la llamada anterior a la función.
-
ppProvCertContext [out]
-
En una búsqueda correcta, se devuelve un puntero al certificado encontrado en este parámetro.
Valor devuelto
Devuelve TRUE si la función se realiza correctamente o FALSE si se produce un error.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows Server 2003 [solo aplicaciones de escritorio] |
Consulte también