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.
| Valore | Significato |
|---|---|
|
Il provider archivia i certificati, gli elenchi di revoche di certificati e gli elenchi di attendibilità dei certificati esterni alla cache dell'archivio. |
|
L'archivio è stato eliminato correttamente. Il callback CertStoreProvCloseCallback non viene chiamato. |
|
Per impostazione predefinita, il provider mantiene le modifiche apportate all'archivio. Se questo flag è impostato, il provider non mantiene le modifiche apportate all'archivio. |
|
Il provider rende persistenti i contesti in un archivio di sistema. |
|
Il provider rende persistenti i contesti in un archivio di sistema LocalMachine. |
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
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Intestazione | wincrypt.h |