CERT_PHYSICAL_STORE_INFO 結構 (wincrypt.h)
CERT_PHYSICAL_STORE_INFO 結構包含實體證書存儲的相關信息。 這些結構的某些成員會直接傳遞至 CertOpenStore 的系統呼叫,以開啟實體存放區。
語法
typedef struct _CERT_PHYSICAL_STORE_INFO {
DWORD cbSize;
LPSTR pszOpenStoreProvider;
DWORD dwOpenEncodingType;
DWORD dwOpenFlags;
CRYPT_DATA_BLOB OpenParameters;
DWORD dwFlags;
DWORD dwPriority;
} CERT_PHYSICAL_STORE_INFO, *PCERT_PHYSICAL_STORE_INFO;
成員
cbSize
這個結構的大小,以位元組為單位。
pszOpenStoreProvider
字串的指標,其名稱為 證書存儲 提供者類型。 此字串會傳入 系統呼叫 CertOpenStore ,並決定要開啟之證書存儲的提供者類型。 如需預先定義的證書存儲類型名稱,請參閱 CertOpenStore。
除了預先定義的證書存儲提供者類型之外,還可以使用 CryptInstallOIDFunctionAddress 或 CryptRegisterOIDFunction 安裝並註冊新的存放區提供者類型。 如需詳細資訊,請參閱 CertOpenStore。
dwOpenEncodingType
只有在 lpszStoreProvider 中傳遞CERT_STORE_PROV_MSG、CERT_STORE_PROV_PKCS7或CERT_STORE_PROV_FILENAME時,此成員才適用。 否則,不會使用此成員。
將憑證和 訊息編碼類型 與位 OR 作業結合在一起,一律可以接受,如下列範例所示:
X509_ASN_ENCODING |PKCS_7_ASN_ENCODING目前定義的編碼類型如下:
- X509_ASN_ENCODING
- PKCS_7_ASN_ENCODING
dwOpenFlags
如果使用SERVICES或USERS存放區位置開啟系統存放區, dwOpenFlags 存放區位置會設定為CERT_SYSTEM_STORE_USERS或CERT_SYSTEM_STORE_SERVICES。
OpenParameters
CRYPT_DATA_BLOB,其中包含要傳遞至 CertOpenStore 函式之 pvPara 參數的數據。 數據類型取決於指定的提供者。 如需要傳遞之類型和內容的詳細資訊,請參閱 CertOpenStore 中可用提供者的描述。
dwFlags
定義CERT_PHYSICAL_STORE_INFO的下列 dwFlags 值。
值 | 意義 |
---|---|
|
啟用將 內容 新增至存放區。 |
|
由 CertRegisterPhysicalStore 函式設定。 根據預設,位於登錄中的所有系統存放區都有已開啟的隱含 SystemRegistry 實體存放區。 若要停用此存放區的開啟,必須藉由設定CERT_PHYSICAL_STORE_OPEN_DISABLE_FLAG或註冊名為 「的實體存放區,來註冊對應至系統存放區的 SystemRegistry 實體存放區。默認值為 CertRegisterPhysicalStore。 |
|
停用實體存放區的遠端開啟。 |
|
Places 其他提供者類型前面的字串 \\ComputerName。 |
|
可讓 CertOpenStore 開啟相對於使用者指定 HKEY 的存放區,而不是其中一個預先定義的 HKEY 常數。 例如,HKEY_CURRENT_USER可以取代為使用者指定的 HKEY。 設定CERT_SYSTEM_STORE_RELOCATE_FLAG時,傳遞至 CertOpenStore 的 pvPara 參數會指向CERT_SYSTEM_STORE_RELOCATE_PARA結構,而不是以 Null 終止的 Unicode 或 ASCII 字串來指向存放區名稱。 |
dwPriority
當系統存放區開啟時,其實體存放區會根據其 dwPriority 設定排序。 較高的 dwPriority 表示優先順序較高。 dwPriority 成員會傳遞至 CertAddStoreToCollection。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
標頭 | wincrypt.h |