estructura CERT_STORE_PROV_INFO (wincrypt.h)
La estructura CERT_STORE_PROV_INFO contiene información devuelta por la función CertDllOpenStoreProv instalada cuando se abre un almacén mediante el uso de .
Función CertOpenStore .
Al abrir un almacén, la función CertOpenStore establece todos los campos de la estructura CERT_STORE_PROV_INFO en cero excepto cbSize, que se establece en el tamaño de CERT_STORE_PROV_INFO. La estructura se actualiza mediante la función installable CertDllOpenStoreProv . Si no hay ninguna función de devolución de llamada adicional a la que se va a llamar, cStoreProvFunc permanece cero al devolverse.
Sintaxis
typedef struct _CERT_STORE_PROV_INFO {
DWORD cbSize;
DWORD cStoreProvFunc;
void **rgpvStoreProvFunc;
HCERTSTOREPROV hStoreProv;
DWORD dwStoreProvFlags;
HCRYPTOIDFUNCADDR hStoreProvFuncAddr2;
} CERT_STORE_PROV_INFO, *PCERT_STORE_PROV_INFO;
Miembros
cbSize
Contiene el tamaño, en bytes, de esta estructura.
cStoreProvFunc
Contiene el número de elementos de la matriz rgpvStoreProvFunc . Este recuento debe incluir los valores NULL que se usan en los índices antes de la última función de devolución de llamada implementada. Por ejemplo, si solo se implementa una función de devolución de llamada, pero está en el índice 2 (CERT_STORE_PROV_WRITE_CERT_FUNC), con NULL para los índices 0 y 1, se debe pasar el número 3 para este parámetro.
rgpvStoreProvFunc
Matriz de punteros a las funciones de devolución de llamada que implementa el proveedor. Esta matriz se indexa mediante los valores especificados en la tabla siguiente y deben estar en el orden que se muestra. También se muestra la función de devolución de llamada asociada. Todas las funciones de devolución de llamada que no están implementadas deben establecerse en NULL. La matriz no tiene que contener todos los índices de función de devolución de llamada, solo debe contener el índice de función de devolución de llamada más alto implementado. Por ejemplo, si solo se implementa la función de devolución de llamada de CERT_STORE_PROV_WRITE_CERT_FUNC (2), la matriz solo debe contener tres elementos.
hStoreProv
Valor definido por la aplicación de 32 bits que es el primer parámetro pasado a todas las devoluciones de llamada. Una aplicación puede especificar el contenido de este miembro según sea necesario. Normalmente, se trata de un puntero a los datos específicos de la aplicación, como la información de estado del proveedor para cada almacén abierto.
dwStoreProvFlags
Contiene un conjunto de marcas que especifican cómo funciona el proveedor. Contiene cero o una combinación de uno o varios de los valores siguientes.
| Valor | Significado |
|---|---|
|
El proveedor almacena certificados, listas de revocación de certificados y listas de confianza de certificados que son externos a la memoria caché del almacén. |
|
El almacén se eliminó correctamente. No se llama a la devolución de llamada CertStoreProvCloseCallback . |
|
De forma predeterminada, el proveedor conservará los cambios realizados en el almacén. Si se establece esta marca, el proveedor no conserva los cambios realizados en el almacén. |
|
El proveedor conserva los contextos en un almacén del sistema. |
|
El proveedor conserva los contextos en un almacén del sistema LocalMachine. |
hStoreProvFuncAddr2
Contiene el identificador devuelto por CryptGetOIDFunctionAddress. CertCloseStore llama a CryptFreeOIDFunctionAddress para liberar un hStoreProvFuncAddr2 distinto de null. Esto permite que la devolución de llamada llame a una otra función instalable que se liberará cuando se cierre el almacén.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Encabezado | wincrypt.h |