共用方式為


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

除了預先定義的證書存儲提供者類型之外,還可以使用 CryptInstallOIDFunctionAddressCryptRegisterOIDFunction 安裝並註冊新的存放區提供者類型。 如需詳細資訊,請參閱 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 值。

意義
CERT_PHYSICAL_STORE_ADD_ENABLE_FLAG
啟用將 內容 新增至存放區。
CERT_PHYSICAL_STORE_OPEN_DISABLE_FLAG
CertRegisterPhysicalStore 函式設定。 根據預設,位於登錄中的所有系統存放區都有已開啟的隱含 SystemRegistry 實體存放區。 若要停用此存放區的開啟,必須藉由設定CERT_PHYSICAL_STORE_OPEN_DISABLE_FLAG或註冊名為 「的實體存放區,來註冊對應至系統存放區的 SystemRegistry 實體存放區。默認值為 CertRegisterPhysicalStore
CERT_PHYSICAL_STORE_REMOTE_OPEN_DISABLE_FLAG
停用實體存放區的遠端開啟。
CERT_PHYSICAL_STORE_INSERT_COMPUTER_NAME_ENABLE_FLAG
Places 其他提供者類型前面的字串 \\ComputerName。
CERT_SYSTEM_STORE_RELOCATE_FLAG
可讓 CertOpenStore 開啟相對於使用者指定 HKEY 的存放區,而不是其中一個預先定義的 HKEY 常數。 例如,HKEY_CURRENT_USER可以取代為使用者指定的 HKEY。 設定CERT_SYSTEM_STORE_RELOCATE_FLAG時,傳遞至 CertOpenStorepvPara 參數會指向CERT_SYSTEM_STORE_RELOCATE_PARA結構,而不是以 Null 終止的 UnicodeASCII 字串來指向存放區名稱。

dwPriority

當系統存放區開啟時,其實體存放區會根據其 dwPriority 設定排序。 較高的 dwPriority 表示優先順序較高。 dwPriority 成員會傳遞至 CertAddStoreToCollection

規格需求

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

另請參閱

CertAddStoreToCollection

CertOpenStore

CertRegisterPhysicalStore

CryptInstallOIDFunctionAddress

CryptRegisterOIDFunction