CERT_STORE_PROV_INFO struttura (wincrypt.h)

La struttura CERT_STORE_PROV_INFO contiene informazioni restituite dalla funzione CertDllOpenStoreProv installata quando un archivio viene aperto usando
Funzione CertOpenStore .

Quando si apre un archivio, la funzione CertOpenStore imposta tutti i campi nella struttura CERT_STORE_PROV_INFO su zero tranne cbSize, impostato sulle dimensioni di CERT_STORE_PROV_INFO. La struttura viene aggiornata dalla funzione installabile CertDllOpenStoreProv . Se non sono presenti altre funzioni di callback da chiamare, cStoreProvFunc rimane zero al ritorno.

Sintassi

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;

Members

cbSize

Contiene le dimensioni, in byte, di questa struttura.

cStoreProvFunc

Contiene il numero di elementi nella matrice rgpvStoreProvFunc . Questo conteggio deve includere tutti i valori NULL usati negli indici prima dell'ultima funzione di callback implementata. Ad esempio, se viene implementata una sola funzione di callback, ma è all'indice 2 (CERT_STORE_PROV_WRITE_CERT_FUNC), con NULL per indici 0 e 1, il numero 3 deve essere passato per questo parametro.

rgpvStoreProvFunc

Matrice di puntatori alle funzioni di callback implementate dal provider. Questa matrice viene indicizzata dai valori specificati nella tabella seguente e devono trovarsi nell'ordine visualizzato. Viene visualizzata anche la funzione di callback associata. Tutte le funzioni di callback non implementate devono essere impostate su NULL. La matrice non deve contenere tutti gli indici delle funzioni di callback, deve contenere solo l'indice di funzione callback più alto implementato. Ad esempio, se viene implementata solo la funzione di callback CERT_STORE_PROV_WRITE_CERT_FUNC (2), la matrice deve contenere solo tre elementi.

hStoreProv

Valore definito dall'applicazione a 32 bit che è il primo parametro passato a tutti i callback. Un'applicazione può specificare il contenuto di questo membro in base alle esigenze. In genere, si tratta di un puntatore ai dati specifici dell'applicazione, ad esempio informazioni sullo stato del provider per ogni archivio aperto.

dwStoreProvFlags

Contiene un set di flag che specificano il funzionamento del provider. Contiene zero o una combinazione di uno o più dei valori seguenti.

hStoreProvFuncAddr2

Contiene l'handle restituito da CryptGetOIDFunctionAddress. CertCloseStore chiama CryptFreeOIDFunctionAddress per liberare un hStoreProvFuncAddr2 diverso da null. In questo modo il callback può chiamare un'altra funzione installabile che verrà liberata quando l'archivio viene chiuso.

Requisiti