Función de devolución de llamada CertStoreProvFindCTL

  • Artículo

La función de devolución de llamada CertStoreProvFindCTL enumera o busca el primer o siguiente CTL en un almacén externo que coincida con los criterios especificados.

Sintaxis

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
);

Parámetros

hStoreProv [in]

HCERTSTOREPROV identificador a un almacén de certificados.

pFindInfo [in]

Puntero a una estructura CERT_STORE_PROV_FIND_INFO que contiene todos los parámetros pasados a CertFindCTLInStore. .

pPrevCtlContext [in]

Puntero a una estructura CTL_CONTEXT del último CTL 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 ppProvCTLContext 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 al búfer para devolver la información del proveedor del almacén. Opcionalmente, la devolución de llamada puede devolver un puntero para buscar información interna en 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.

ppProvCtlContext [out]

En una búsqueda correcta, se devuelve un puntero al CTL encontrado en este parámetro.

Valor devuelto

Devuelve TRUE si la función se ejecuta 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

CERT_STORE_PROV_FIND_INFO

CertFindCTLInStore

CTL_CONTEXT