CERT_STORE_PROV_INFO-Struktur (wincrypt.h)
Die CERT_STORE_PROV_INFO-Struktur enthält Informationen, die von der installierten CertDllOpenStoreProv-Funktion zurückgegeben werden, wenn ein Speicher mithilfe von geöffnet wird.
CertOpenStore-Funktion .
Beim Öffnen eines Speichers legt die CertOpenStore-Funktion alle Felder in der CERT_STORE_PROV_INFO-Struktur auf null fest, mit Ausnahme von cbSize, das auf die Größe CERT_STORE_PROV_INFO festgelegt ist. Die Struktur wird von der installierbaren Funktion CertDllOpenStoreProv aktualisiert. Wenn keine zusätzlichen Rückruffunktionen aufgerufen werden sollen, bleibt cStoreProvFunc bei der Rückgabe null.
Syntax
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;
Member
cbSize
Enthält die Größe dieser Struktur in Bytes.
cStoreProvFunc
Enthält die Anzahl der Elemente im rgpvStoreProvFunc-Array . Diese Anzahl muss alle NULL-Werte enthalten, die vor der letzten Implementierung der Rückruffunktion in Indizes verwendet werden. Wenn z. B. nur eine Rückruffunktion implementiert ist, diese jedoch bei Index 2 (CERT_STORE_PROV_WRITE_CERT_FUNC) mit NULL für die Indizes 0 und 1 liegt, sollte die Zahl 3 für diesen Parameter übergeben werden.
rgpvStoreProvFunc
Ein Array von Zeigern auf die Rückruffunktionen, die vom Anbieter implementiert werden. Dieses Array wird anhand der werte indiziert, die in der folgenden Tabelle angegeben sind, und sie müssen in der angezeigten Reihenfolge vorliegen. Die zugeordnete Rückruffunktion wird ebenfalls angezeigt. Alle Rückruffunktionen, die nicht implementiert sind, müssen auf NULL festgelegt werden. Das Array muss nicht alle Rückruffunktionsindizes enthalten, es muss nur den höchsten implementierten Rückruffunktionsindex enthalten. Wenn beispielsweise nur die Rückruffunktion CERT_STORE_PROV_WRITE_CERT_FUNC (2) implementiert ist, muss das Array nur drei Elemente enthalten.
hStoreProv
Ein anwendungsdefinierter 32-Bit-Wert, der der erste Parameter ist, der an alle Rückrufe übergeben wird. Eine Anwendung kann den Inhalt dieses Members wie gewünscht angeben. In der Regel handelt es sich dabei um einen Zeiger auf Anwendungsspezifische Daten, z. B. Anbieterstatusinformationen für jeden geöffneten Speicher.
dwStoreProvFlags
Enthält eine Reihe von Flags, die angeben, wie der Anbieter funktioniert. Enthält null oder eine Kombination aus einem oder mehreren der folgenden Werte.
| Wert | Bedeutung |
|---|---|
|
Der Anbieter speichert Zertifikate, Zertifikatsperrlisten und Zertifikatvertrauenslisten , die sich außerhalb des Caches des Speichers befinden. |
|
Der Speicher wurde erfolgreich gelöscht. Der CertStoreProvCloseCallback-Rückruf wird nicht aufgerufen. |
|
Standardmäßig speichert der Anbieter Änderungen, die am Speicher vorgenommen werden. Wenn dieses Flag festgelegt ist, speichert der Anbieter die am Speicher vorgenommenen Änderungen nicht. |
|
Der Anbieter behält Kontexte in einem Systemspeicher bei. |
|
Der Anbieter speichert Kontexte in einem LocalMachine-Systemspeicher. |
hStoreProvFuncAddr2
Enthält das von CryptGetOIDFunctionAddress zurückgegebene Handle. CertCloseStore ruft CryptFreeOIDFunctionAddress auf, um einen hStoreProvFuncAddr2 ungleich NULL frei zu geben. Dadurch kann der Rückruf eine andere installierbare Funktion aufrufen, die freigegeben wird, wenn der Speicher geschlossen wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Kopfzeile | wincrypt.h |