CERT_STORE_PROV_INFO 結構 (wincrypt.h)
CERT_STORE_PROV_INFO 結構包含使用 開啟存放區時所安裝 CertDllOpenStoreProv 函式所傳回的資訊
CertOpenStore 函式。
開啟存放區時, CertOpenStore 函式會將 CERT_STORE_PROV_INFO 結構中的所有欄位設定為零,但 cbSize 除外,這會設定為 CERT_STORE_PROV_INFO的大小。 結構會由 CertDllOpenStoreProv 可安裝函式更新。 如果沒有其他要呼叫的回呼函式, cStoreProvFunc 會在傳回時維持零。
語法
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;
成員
cbSize
包含這個 結構的大小,以位元組為單位。
cStoreProvFunc
包含 rgpvStoreProvFunc 陣列中的項目數目。 此計數必須包含在實作最後一個回呼函式之前,索引中使用的任何 NULL 值。 例如,如果只實作一個回呼函式,但它位於索引 2 (CERT_STORE_PROV_WRITE_CERT_FUNC) ,且索引 0 和 1 為 NULL ,則應該針對此參數傳遞數位 3。
rgpvStoreProvFunc
提供者所實作之回呼函式的指標陣列。 此陣列是由下表中所提供的值編製索引,而且它們必須依顯示的順序排列。 也會顯示相關聯的回呼函式。 所有未實作的回呼函式都必須設定為 NULL。 數位不需要包含所有回呼函式索引,它只需要包含實作的最高回呼函式索引。 例如,如果只實作 CERT_STORE_PROV_WRITE_CERT_FUNC (2) 回呼函式,則陣列只需要包含三個元素。
hStoreProv
32 位的應用程式定義值,這是傳遞至所有回呼的第一個參數。 應用程式可以視需要指定此成員的內容。 一般而言,這是應用程式專屬的數據指標,例如開啟每個存放區的提供者狀態資訊。
dwStoreProvFlags
包含一組旗標,指定提供者的運作方式。 包含零或下列一或多個值的組合。
值 | 意義 |
---|---|
|
提供者會儲存存放存放區快取外部的 憑證、 證書吊銷清單和 憑證信任清單 。 |
|
已成功刪除存放區。 未呼叫 CertStoreProvCloseCallback 回 呼。 |
|
根據預設,提供者會保存對存放區所做的變更。 如果設定此旗標,提供者不會保存對存放區所做的變更。 |
|
提供者會將內容保存到系統存放區。 |
|
提供者會將內容保存到 LocalMachine 系統存放區。 |
hStoreProvFuncAddr2
包含 CryptGetOIDFunctionAddress 所傳回的句柄。 CertCloseStore 會呼叫 CryptFreeOIDFunctionAddress 來釋放非 Null hStoreProvFuncAddr2。 這可讓回呼呼叫另一個可安裝函式,此函式會在存放區關閉時釋出。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
標頭 | wincrypt.h |