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 值。

值 意義
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時，傳遞至 CertOpenStore 的 pvPara 參數會指向CERT_SYSTEM_STORE_RELOCATE_PARA結構，而不是以 Null 終止的 Unicode 或 ASCII 字串來指向存放區名稱。

dwPriority

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

規格需求

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

另請參閱

CertAddStoreToCollection

CertOpenStore

CertRegisterPhysicalStore

CryptInstallOIDFunctionAddress

CryptRegisterOIDFunction