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.

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