estrutura CERT_STORE_PROV_INFO (wincrypt.h)

A estrutura CERT_STORE_PROV_INFO contém informações retornadas pela função CertDllOpenStoreProv instalada quando um repositório é aberto usando o
Função CertOpenStore .

Ao abrir um repositório, a função CertOpenStore define todos os campos na estrutura CERT_STORE_PROV_INFO como zero, exceto cbSize, que é definido como o tamanho de CERT_STORE_PROV_INFO. A estrutura é atualizada pela função instalável CertDllOpenStoreProv . Se não houver funções de retorno de chamada adicionais a serem chamadas, cStoreProvFunc permanecerá zero após o retorno.

Sintaxe

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;

Membros

cbSize

Contém o tamanho, em bytes, dessa estrutura.

cStoreProvFunc

Contém o número de elementos na matriz rgpvStoreProvFunc . Essa contagem deve incluir todos os valores NULL usados em índices antes da última função de retorno de chamada implementada. Por exemplo, se apenas uma função de retorno de chamada for implementada, mas estiver no índice 2 (CERT_STORE_PROV_WRITE_CERT_FUNC), com NULL para índices 0 e 1, o número 3 deverá ser passado para esse parâmetro.

rgpvStoreProvFunc

Uma matriz de ponteiros para as funções de retorno de chamada implementadas pelo provedor. Essa matriz é indexada pelos valores fornecidos na tabela a seguir e eles devem estar na ordem mostrada. A função de retorno de chamada associada também é mostrada. Todas as funções de retorno de chamada que não são implementadas devem ser definidas como NULL. A matriz não precisa conter todos os índices de função de retorno de chamada, ela só precisa conter o índice de função de retorno de chamada mais alto implementado. Por exemplo, se apenas a função de retorno de chamada CERT_STORE_PROV_WRITE_CERT_FUNC (2) for implementada, a matriz só precisará conter três elementos.

hStoreProv

Um valor definido pelo aplicativo de 32 bits que é o primeiro parâmetro passado para todos os retornos de chamada. Um aplicativo pode especificar o conteúdo desse membro conforme desejado. Normalmente, esse é um ponteiro para dados específicos do aplicativo, como informações de estado do provedor para cada repositório aberto.

dwStoreProvFlags

Contém um conjunto de sinalizadores que especificam como o provedor funciona. Contém zero ou uma combinação de um ou mais dos valores a seguir.

hStoreProvFuncAddr2

Contém o identificador retornado por CryptGetOIDFunctionAddress. CertCloseStore chama CryptFreeOIDFunctionAddress para liberar um hStoreProvFuncAddr2 não nulo. Isso permite que o retorno de chamada chame uma outra função instalável que será liberada quando o repositório for fechado.

Requisitos