共用方式為


私密金鑰快取常數

下列常數是用來代表控制 Microsoft 軟體型 CSP 所快取 私密金鑰 的登錄專案。

常數/值 Description
szKEY_CRYPTOAPI_PRI加值稅E_KEY_OPTIONS
「Software\\Policies\\Microsoft\\Cryptography」
私密金鑰快取登錄專案之 HKEY_LOCAL_MACHINE 根目錄下的路徑。

下列常數是用來識別登錄值,這些登錄值可控制 Microsoft 軟體型 CSP 針對特定程式全域快取私密金鑰。

常數/值 Description
szPRIV_KEY_CACHE_MAX_ITEMS
「PrivKeyCacheMaxItems」
szKEY_CRYPTOAPI_PRI加值稅E_KEY_OPTIONS登錄機碼下REG_DWORD值,指定單一進程一次快取的私密金鑰數目上限。 每當讀取預存私密金鑰時,就會執行這項檢查。 如果超過最大數目,則會從快取中移除最近使用的最小索引鍵。
如果此值為零,則不會快取任何索引鍵。 如果此值不存在, 則會使用cPRIV_KEY_CACHE_MAX_ITEMS_DEFAULT 值做為預設值。
如果目前在開啟的內容中參考從快取中刪除的私密金鑰,則在下次嘗試使用金鑰時,會從儲存體讀取金鑰。
Windows Server 2003 和 Windows XP SP1 和更早版本: 不支援此登錄值。
cPRIV_KEY_CACHE_MAX_ITEMS_DEFAULT
20
如果未指定任何值 ,則為szPRIV_KEY_CACHE_MAX_ITEMS 登錄專案的預設值。
szPRIV_KEY_CACHE_PURGE_INTERVAL_SECONDS
「PrivKeyCachePurgeIntervalSeconds」
szKEY_CRYPTOAPI_PRI加值稅E_KEY_OPTIONS登錄機碼下REG_DWORD值,指定任何快取私密金鑰的最大存留期,以秒為單位。 每當使用或讀取預存私密金鑰時,就會執行這項檢查。 如果上次清除之後經過這個時間量,則自上次清除之後尚未參考的所有快取索引鍵都會從快取中移除。
如果此值不存在, 則會使用cPRIV_KEY_CACHE_PURGE_INTERVAL_SECONDS_DEFAULT 值做為預設值。
如果目前在開啟的內容中參考從快取清除的私密金鑰,下次嘗試使用金鑰時,將會從儲存體讀取金鑰。
Windows Server 2003 和 Windows XP SP1 和更早版本: 不支援此登錄值。
cPRIV_KEY_CACHE_PURGE_INTERVAL_SECONDS_DEFAULT
86400
如果未指定任何值 ,szPRIV_KEY_CACHE_PURGE_INTERVAL_SECONDS 登錄專案的預設值。 此值相當於一天。

下列常數是用來識別登錄值,以控制單一 Microsoft 軟體型 密碼編譯服務提供者 的私密金鑰快取, (CSP) 實例。

常數/值 Description
「AllowCachePW」
HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Cryptography\Protect登錄機碼底下的REG_DWORD值,指定 Microsoft 軟體型 CSP 中是否啟用受密碼保護金鑰的密碼快取。 如果此值為 0,則會解除標記密碼快取,並在每次使用受密碼保護的金鑰時提示使用者輸入密碼。 任何其他值或沒有此值,表示將會快取密碼。 在此案例中,只會針對每個這類金鑰的每個進程提示使用者一次。
szKEY_CACHE_ENABLED
「CachePrivateKeys」
szKEY_CRYPTOAPI_PRI加值稅E_KEY_OPTIONS登錄機碼下REG_DWORD值,指定是否啟用私密金鑰快取。 如果此值為 1,則會啟用私密金鑰快取。 任何其他值或沒有此值,表示私密金鑰快取已停用。
Windows Vista SP1、Windows Vista 和 Windows XP: 不支援此登錄值。
szKEY_CACHE_SECONDS
「PrivateKeyLifetimeSeconds」
szKEY_CRYPTOAPI_PRI加值稅E_KEY_OPTIONS登錄機碼下REG_DWORD值,指定任何快取私密金鑰的最大存留期,以秒為單位。
Windowsxp: 不支援此登錄值。

備註

szKEY_CACHE_SECONDSszPRIV_KEY_CACHE_PURGE_INTERVAL_SECONDS值之間的差異如下:

szKEY_CACHE_SECONDS

  • 此值僅適用于特定的 CSP。 發行 CSP 之後,也會釋放 CSP 的快取。
  • 只有在嘗試搭配特定內容控制碼使用特定私密金鑰時,才會套用此值。

szPRIV_KEY_CACHE_PURGE_INTERVAL_SECONDS

  • 此值適用于進程中的所有 CSP。 即使已釋放 CSP,也不會釋放此快取。
  • 每當在單一進程中使用或讀取任何儲存的私密金鑰時,就會套用此值。

規格需求

需求
最低支援的用戶端
Windows XP [僅限傳統型應用程式]
最低支援的伺服器
Windows Server 2003 [僅限傳統型應用程式]
標頭
Wincrypt.h