CertOpenStore 函式 (wincrypt.h)

CertOpenStore 函式會使用指定的存放區提供者類型開啟證書存儲。 雖然此函式可以針對大部分用途開啟證書存儲,但建議 使用 CertOpenSystemStore 來開啟最常見的證書存儲。 CertOpenStore 是更複雜的選項和特殊案例的必要專案。

語法

HCERTSTORE CertOpenStore(
  [in] LPCSTR            lpszStoreProvider,
  [in] DWORD             dwEncodingType,
  [in] HCRYPTPROV_LEGACY hCryptProv,
  [in] DWORD             dwFlags,
  [in] const void        *pvPara
);

參數

[in] lpszStoreProvider

包含存放區提供者類型的 Null 終止 ANSI 字串指標。

下列值代表預先定義的存放區類型。 存放區提供者類型會決定 pvPara 參數的內容,以及 dwFlags 參數高字的使用和意義。 您可以使用 CryptInstallOIDFunctionAddressCryptRegisterOIDFunction 函式來安裝或註冊其他存放區提供者。 如需新增存放區提供者的詳細資訊,請參閱 擴充 CertOpenStore 功能

意義
CERT_STORE_PROV_COLLECTION
sz_CERT_STORE_PROV_COLLECTION
開啟將會是其他商店集合的存放區。 使用 CertAddStoreToCollectionCertRemoveStoreFromCollection,將存放區新增至或從集合中移除。 將存放區新增至集合時,該存放區中的所有憑證、CRL 和 CCL 都可供搜尋或列舉集合存放區。

dwFlags 的高字設為零。

pvPara 值:pvPara參數必須是 NULL

CERT_STORE_PROV_FILE
使用從指定的開啟檔案讀取的憑證、CRL 和 CCL,初始化存放區。 此提供者預期檔案只包含串行化的存放區,而不是 PKCS #7 簽署的訊息或單一編碼憑證。

檔案指標必須位於串行化存放區資訊的開頭。 將串行化存放區中的數據載入證書存儲之後,檔案指標會放在任何可遵循串行化存放區數據的數據開頭。 如果CERT_FILE_STORE_COMMIT_ENABLE是在 dwFlags 中設定,則會複製檔句柄,而且一律會將存放區認可為串行化存放區。 當存放區關閉時,檔案不會關閉。

pvPara 值:pvPara參數必須包含使用 CreateFile 開啟之檔案句柄的指標。

CERT_STORE_PROV_FILENAME_A
使用檔案中的憑證、CRL 和 CCL 初始化存放區。 提供者會開啟檔案,然後先嘗試將檔案讀取為串行化存放區,然後以 PKCS #7 簽署的訊息,最後做為單一編碼憑證。

dwEncodingType 參數必須包含要同時用於訊息和憑證的編碼類型。 如果檔案包含 X.509 編碼的憑證,則開啟作業會失敗,而且 GetLastError 函式的呼叫將會傳回 ERROR_ACCESS_DENIED。 如果CERT_FILE_STORE_COMMIT_ENABLE旗標是在 dwFlags 中設定,則傳遞至 CreateFiledwCreationDisposition 值如下所示:

  • 如果 已設定CERT_STORE_CREATE_NEW_FLAG 旗標, CreateFile 會使用 CREATE_NEW
  • 如果已設定 CERT_STORE_OPEN_EXISTING_FLAG 旗標, CreateFile 會使用 OPEN_EXISTING
  • 針對 dwFlags 的其他所有設定, CreateFile 會使用 OPEN_ALWAYS

如果 dwFlags 包含 CERT_FILE_STORE_COMMIT_ENABLE,則會根據開啟的文件類型,將檔案認可為 PKCS #7 或串行化存放區。 如果檔案是空的,或檔名具有 .p7c 或 .spc 擴展名,則會將檔案認可為 PKCS #7。 否則,檔案會認可為串行化存放區。

pvPara 值:pvPara參數必須包含 Null 終止 ANSI 字串的指標,其中包含現有未開啟的檔案名稱。

CERT_STORE_PROV_FILENAME (_W)
sz_CERT_STORE_PROV_FILENAME (_W)
CERT_STORE_PROV_FILENAME_A相同。

pvPara 值:pvPara參數必須包含 Null 終止 Unicode 字串的指標,其中包含現有未開啟的檔案名稱。

CERT_STORE_PROV_LDAP (_W)
sz_CERT_STORE_PROV_LDAP (_W)
使用LDAP查詢結果中的憑證、CRL和 CCL,初始化存放區。

若要在存放區上執行寫入作業,查詢字串必須指定沒有篩選條件和單一屬性的BASE查詢。

pvPara 值: 如果 dwFlags 參數包含 CERT_LDAP_STORE_OPENED_FLAG,請將 pvPara 設定為指定所建立 LDAP 會話使用的 CERT_LDAP_STORE_OPENED_PARA 結構位址。

否則,請將 pvPara 設定為指向包含 LDAP 查詢字串的 Null 終止 Unicode 字串。 如需LDAP查詢字串的詳細資訊,請參閱 LDAP方言

CERT_STORE_PROV_MEMORY
sz_CERT_STORE_PROV_MEMORY
在快取記憶體中建立證書存儲。 沒有憑證、 證書吊銷清單 (CRL) ,或憑證 信任清單 (CCL) 一開始會載入至存放區。 通常用來建立暫存存放區。

不會自動儲存記憶體存放區中憑證、CRL 或 CCL 屬性的任何憑證、CRL 或 CCL 或變更。 它們可以使用 CertSaveStore 儲存至檔案或記憶體 BLOB

pvPara 值: 不會使用 pvPara 參數。

CERT_STORE_PROV_MSG
使用來自指定密碼編譯訊息的憑證、CRL 和 CCL,初始化存放區。 dwEncodingType 參數必須包含用於訊息和憑證的編碼類型。

pvPara 值:pvPara參數包含編碼訊息的 HCRYPTMSG 句柄,由對 CryptMsgOpenToDecode 的呼叫所傳回。

CERT_STORE_PROV_PHYSICAL (_W)
sz_CERT_STORE_PROV_PHYSICAL (_W)
從屬於邏輯系統存放區成員的指定實體存放區,使用憑證、CRL 和 CCL 初始化存放區。

兩個名稱會以交錯反斜杠分隔 (\) ,例如 “Root.Default”。 在這裡,“Root” 是系統存放區和 “的名稱。預設值為實體存放區的名稱。 系統和實體存放區名稱不能包含任何反斜杠。 dwFlags 的高字表示系統存放區位置,通常CERT_SYSTEM_STORE_CURRENT_USER。 如需詳細資訊,請參閱本主題稍後 的 dwFlags ,並參閱 系統存放區位置。 某些實體存放區位置可以從遠端開啟。

pvPara 值:pvPara參數指向 Null 終止的 Unicode 字串,其中包含系統存放區名稱和實體名稱。

CERT_STORE_PROV_PKCS7
sz_CERT_STORE_PROV_PKCS7
使用已編碼 PKCS #7 簽署訊息中的憑證、CRL 和 CCL,初始化存放區。 dwEncodingType 參數必須指定用於訊息和憑證的編碼類型。

pvPara 值:pvPara參數指向代表編碼訊息的CRYPT_DATA_BLOB結構。

CERT_STORE_PROV_PKCS12
sz_CERT_STORE_PROV_PKCS12
使用 PKCS #12 封包的內容,初始化存放區。

如果 PKCS #12 封包受到 NULL 或空白密碼的保護,此函式將會成功開啟存放區。

從 Windows 8 和 Windows Server 2012 開始,如果內嵌在 PFX 封包中的密碼受到 Active Directory (AD) 主體的保護,且目前使用者身為該主體的成員,則此函式將會成功開啟存放區。 如需詳細資訊,請參閱 pvPara 參數和 PFXExportCertStoreEx 函式的PKCS12_PROTECT_TO_DOMAIN_SIDS旗標。

您可以從 Windows 8 和 Windows Server 2012 開始保護 AD 主體的 PFX 密碼。

pvPara 值:pvPara參數指向代表 PKCS #12 封包的CRYPT_DATA_BLOB結構。

CERT_STORE_PROV_REG
使用登錄子機碼中的憑證、CRL 和 CCL,初始化存放區。

此提供者會在 pvPara 中傳遞的機碼底下開啟或建立登錄子機碼憑證CRLCCL。 提供者不會關閉輸入索引鍵。 在傳回之前,提供者會開啟它自己在 pvPara 中傳遞的密鑰複本。 如果CERT_STORE_READONLY_FLAG是以 dwFlags 的低字設定,則會使用具有KEY_READ_ACCESS的 RegOpenKey 來開啟登錄子機碼。 否則,會使用 RegCreateKey 搭配 KEY_ALL_ACCESS來建立登錄子機碼。 對開啟存放區內容所做的任何變更都會立即保存到登錄。 不過,如果CERT_STORE_READONLY_FLAG是在 dwFlags 的低字中設定,則任何嘗試新增至存放區的內容,或變更內容屬性會導致 GetLastError 傳回E_ACCESSDENIED程式代碼時發生錯誤。

pvPara 值:pvPara參數包含開啟登錄機碼的句柄。

CERT_STORE_PROV_SERIALIZED
sz_CERT_STORE_PROV_SERIALIZED
從包含串行化存放區的記憶體位置,使用憑證、CRL 和 CCL 初始化存放區。

pvPara 值:pvPara參數指向包含串行化記憶體 BLOB 的CRYPT_DATA_BLOB結構。

CERT_STORE_PROV_SMART_CARD (_W)
sz_CERT_STORE_PROV_SMART_CARD (_W)
目前無法使用。
CERT_STORE_PROV_SYSTEM_A
使用指定之系統存放區中的憑證、CRL 和 CCL 初始化存放區。

系統存放區是邏輯集合存放區,其中包含一或多個實體存放區。 與系統存放區相關聯的實體存放區會向 CertRegisterPhysicalStore 函式註冊。 系統存放區開啟之後,所有與其相關聯的實體存放區也會由呼叫 CertOpenStore 開啟,並使用 CertAddStoreToCollection 函式新增至系統存放區集合。 dwFlags 的高字表示系統存放區位置,通常設定為 CERT_SYSTEM_STORE_CURRENT_USER。 如需登錄位置的詳細資訊,請參閱本主題稍後 的 dwFlags系統存放區位置。 某些系統存放區位置可以從遠端開啟;如需詳細資訊,請參閱系統存放區位置。

pvPara 值:pvPara參數指向以 Null 結尾的 ANSI 字串,其中包含系統存放區名稱,例如 “My” 或 “Root”。

CERT_STORE_PROV_SYSTEM (_W)
sz_CERT_STORE_PROV_SYSTEM (_W)
CERT_STORE_PROV_SYSTEM_A相同。

pvPara 值:pvPara參數指向包含系統存放區名稱的 Null 終止 Unicode 字串,例如 “My” 或 “Root”。

CERT_STORE_PROV_SYSTEM_REGISTRY_A
使用實體登錄存放區中的憑證、CRL 和 CCL 初始化存放區。 實體存放區不會開啟為集合存放區。 列舉和搜尋只會經歷該實體存放區中的憑證、CRL 和 CCL。

dwFlags 的高字表示系統存放區位置,通常設定為 CERT_SYSTEM_STORE_CURRENT_USER。 如需詳細資訊,請參閱本主題稍後 的 dwFlags 。 某些系統存放區位置可以從遠端開啟;如需詳細資訊,請參閱 系統存放區位置

pvPara 值:pvPara參數指向以 Null 結尾的 ANSI 字串,其中包含系統存放區名稱,例如 “My” 或 “Root”。

CERT_STORE_PROV_SYSTEM_REGISTRY (_W)
sz_CERT_STORE_PROV_SYSTEM_REGISTRY (_W)
CERT_STORE_PROV_SYSTEM_REGISTRY_A相同。

pvPara 值:pvPara參數指向包含系統存放區名稱的 Null 終止 Unicode 字串,例如 “My” 或 “Root”。

[in] dwEncodingType

指定憑證編碼類型和訊息編碼類型。 只有在 CertSaveStore 函式的 dwSaveAs 參數包含 CERT_STORE_SAVE_AS_PKCS7時,才會使用編碼。 否則,不會使用 dwMsgAndCertEncodingType 參數。

只有在 lpszStoreProvider 參數中指定了CERT_STORE_PROV_MSGCERT_STORE_PROV_PKCS7CERT_STORE_PROV_FILENAME提供者類型時,才適用此參數。 對於所有其他提供者類型,此參數未使用,且應該設定為零。

此參數可以是下列一或多個值的組合。

意義
PKCS_7_ASN_ENCODING
65536 (0x10000)
指定 PKCS #7 訊息編碼。
X509_ASN_ENCODING
1 (0x1)
指定 X.509 憑證編碼。

[in] hCryptProv

不使用此參數,而且應該設定為 NULL

Windows Server 2003 和 Windows XP: 密碼編譯提供者的句柄。 傳遞此參數的 NULL 會導致使用適當的預設提供者。 建議使用預設提供者。 默認或指定的密碼編譯提供者會用於驗證主體憑證或CRL簽章的所有存放區函式。此參數的數據類型為 HCRYPTPROV

[in] dwFlags

這些值是由使用位 OR 運算結合的高字和低字值所組成。

dwFlags 的低字部分會控制開啟證書存儲的各種一般特性。 此部分可以搭配所有市集提供者類型使用。 dwFlags 的低字部分可以是下列其中一個值。

意義
CERT_STORE_BACKUP_RESTORE_FLAG
使用線程的SE_BACKUP_NAME和SE_RESTORE_NAME 許可權 來開啟登錄或檔案型系統存放區。 如果線程沒有這些許可權,此函式必須失敗,並發生拒絕存取錯誤。
CERT_STORE_CREATE_NEW_FLAG
如果不存在新存放區,就會建立新的存放區。 如果存放區已經存在,函式就會失敗。

如果未 設定CERT_STORE_OPEN_EXISTING_FLAGCERT_STORE_CREATE_NEW_FLAG ,則會在存放區存在或建立時開啟,如果尚未存在,則會開啟存放區。

CERT_STORE_DEFER_CLOSE_UNTIL_LAST_FREE_FLAG
延遲關閉存放區的提供者,直到所有從存放區取得的憑證、CRL 或 CCL 都不再使用為止。 當從存放區取得的最後一個憑證、CRL 或 CTL 釋放時,就會實際關閉存放區。 即使呼叫 CertCloseStore 之後,對這些憑證、CRL 和 CCL 的屬性所做的任何變更仍會保存。

如果未設定此旗標,且從存放區取得的憑證、CRL 或 CCL 仍在使用中,則不會保存這些憑證、CRL 和 CCL 屬性的任何變更。

如果使用 CERT_CLOSE_STORE_FORCE_FLAG呼叫此函式, 則會忽略CERT_STORE_DEFER_CLOSE_UNTIL_LAST_FREE_FLAG

設定此旗標並傳遞非 NULLhCryptProv 參數值時,即使呼叫此函式之後,仍會繼續使用該提供者。

CERT_STORE_DELETE_FLAG
刪除存放區,而不是開啟。 此函式會針對刪除成功和失敗傳回 NULL 。 若要判斷刪除成功,請呼叫 GetLastError,如果刪除存放區,則會傳回零,如果未刪除,則會傳回非零值。
CERT_STORE_ENUM_ARCHIVED_FLAG
一般而言,存放區中所有憑證的列舉都會忽略任何已設定 CERT_ARCHIVED_PROP_ID 屬性的 憑證。 如果設定此旗標,則存放區中憑證的列舉將包含存放區中的所有憑證,包括具有 CERT_ARCHIVED_PROP_ID 屬性的憑證。
CERT_STORE_MAXIMUM_ALLOWED_FLAG
開啟具有最大允許許可權集的存放區。 如果指定此旗標,登錄存放區會先以寫入存取權開啟,如果失敗,則會以只讀存取重新開啟。
CERT_STORE_NO_CRYPT_RELEASE_FLAG
當 hCryptProv 參數為 NULL 時,不會使用此旗標。 只有在傳遞非 NULL CSP 句柄作為 hCryptProv 參數時,此旗標才有效。 設定此旗標可防止關閉證書存儲時自動發行非預設 CSP。
CERT_STORE_OPEN_EXISTING_FLAG
只開啟現有的存放區。 如果存放區不存在,函式會失敗。
CERT_STORE_READONLY_FLAG
在唯讀模式開啟存放區。 任何嘗試變更存放區的內容都會造成錯誤。 設定此旗標並使用以登錄為基礎的存放區提供者時,會使用 具有 KEY_READ_ACCESS的 RegOpenKey 來開啟 登錄子機碼。 否則,會使用 RegCreateKey 搭配 KEY_ALL_ACCESS 來建立 登錄子機碼。
CERT_STORE_SET_LOCALIZED_NAME_FLAG
如果支援此旗標,提供者會設定存放區的 CERT_STORE_LOCALIZED_NAME_PROP_ID 屬性。 呼叫 CertGetStoreProperty 函式,並將 dwPropID 設定為 CERT_STORE_LOCALIZED_NAME_PROP_ID,即可擷取本地化的名稱。 此旗標支援類型 提供者CERT_STORE_PROV_FILENAMECERT_STORE_PROV_SYSTEMCERT_STORE_PROV_SYSTEM_REGISTRYCERT_STORE_PROV_PHYSICAL_W
CERT_STORE_SHARE_CONTEXT_FLAG
開啟存放區多次時,您可以設定此旗標,藉由將憑證、CRL 或 CTL 內容編碼部分的記憶體重複使用到存放區的已開啟實例,以確保有效率的記憶體使用量。
CERT_STORE_UPDATE_KEYID_FLAG
密鑰標識碼 清單 存在於 CurrentUser 和 LocalMachine 內。 這些金鑰標識碼的屬性非常類似憑證的屬性。 如果 已設定CERT_STORE_UPDATE_KEYID_FLAG ,則針對存放區位置中具有 CERT_KEY_PROV_INFO_PROP_ID 屬性的每個密鑰標識碼,該屬性會自動從密鑰標識碼屬性更新 CERT_KEY_PROV_INFO_PROP_ID 或與該金鑰標識碼相關的憑證 CERT_KEY_IDENTIFIER_PROP_ID
 

CERT_STORE_PROV_SYSTEMCERT_STORE_PROV_SYSTEM_REGISTRYCERT_STORE_PROV_PHYSICAL提供者類型會使用下列高字 dwFlags 來指定系統存放區登錄位置:

CERT_SYSTEM_STORE_CURRENT_SERVICE

CERT_SYSTEM_STORE_CURRENT_USER

CERT_SYSTEM_STORE_CURRENT_USER_GROUP_POLICY

CERT_SYSTEM_STORE_LOCAL_MACHINE

CERT_SYSTEM_STORE_LOCAL_MACHINE_ENTERPRISE

CERT_SYSTEM_STORE_LOCAL_MACHINE_GROUP_POLICY

CERT_SYSTEM_STORE_SERVICES

CERT_SYSTEM_STORE_USERS

根據預設,系統存放區位置會相對於 HKEY_CURRENT_USERHKEY_LOCAL_MACHINE預先定義的 登錄機碼HKEY_USERS開啟。 如需詳細資訊,請參閱 系統存放區位置

下列高字旗標會覆寫此預設行為。

意義
CERT_SYSTEM_STORE_RELOCATE_FLAG
設定時, pvPara 必須包含 CERT_SYSTEM_STORE_RELOCATE_PARA 結構的指標,而不是字串。 結構會指出存放區的名稱及其在登錄中的位置。
CERT_SYSTEM_STORE_UNPROTECTED_FLAG
根據預設,當 CurrentUser “Root” 存放區開啟時,此函式傳回之前,不會在受保護的根清單上的任何 SystemRegistry 根目錄都會從快取中刪除。 設定此旗標時,會覆寫此預設值,並傳回 SystemRegistry 中的所有根目錄,而且不會檢查受保護的根清單。
 

CERT_STORE_PROV_REGISTRY提供者會使用下列高字旗標。

意義
CERT_REGISTRY_STORE_REMOTE_FLAG
pvPara 包含遠端電腦上的登錄機碼句柄。 若要存取遠端電腦上的登錄機碼,遠端電腦上的安全性許可權必須設定為允許存取。 如需詳細資訊,請參閱<備註>。
CERT_REGISTRY_STORE_SERIALIZED_FLAG
CERT_STORE_PROV_REG提供者會將憑證、CRL 和 CCL 儲存在單一串行化存放區子機碼中,而不是執行預設儲存作業。 預設值是每個憑證、CRL 或 CTL 都會儲存為適當子機碼底下的個別登錄子機碼。

此旗標主要用於從組策略範本下載的存放區, (GPT) ,例如 CurrentUserGroupPolicy 和 LocalMachineGroupPolicy 存放區。

設定CERT_REGISTRY_STORE_SERIALIZED_FLAG時,除非使用 CERT_STORE_CTRL_COMMIT呼叫 CertCloseStoreCertControlStore,否則不會保存新增、刪除或屬性變更。

 

CERT_STORE_PROV_FILECERT_STORE_PROV_FILENAME提供者類型會使用下列高字旗標。

意義
CERT_FILE_STORE_COMMIT_ENABLE
當呼叫 CertCloseStore 或使用 CERT_STORE_CONTROL_COMMIT 呼叫 CertControlStore 時,設定此旗標會認可對存放區中內容屬性所做的任何新增或變更。

如果 dwFlags同時設定了 CERT_FILE_STORE_COMMIT_ENABLECERT_STORE_READONLY_FLAG,CertOpenStore 就會失敗並E_INVALIDARG。

 

CERT_STORE_PROV_LDAP提供者類型會使用下列高字旗標。

意義
CERT_LDAP_STORE_AREC_EXCLUSIVE_FLAG
pvPara 參數中名為 的 URL 上執行僅限 A-Record 的 DNS 查閱。 這可防止解析 URL 主機名時產生 False DNS 查詢。 傳遞主機名而非 pvPara 參數的功能變數名稱時,請使用此旗標。
CERT_LDAP_STORE_OPENED_FLAG
使用此旗標來使用現有的LDAP會話。 指定此旗標時, pvPara 參數是包含所要使用LDAP會話相關信息 之CERT_LDAP_STORE_OPENED_PARA 結構的位址。
CERT_LDAP_STORE_SIGN_FLAG
若要提供某些應用程式所需的完整性,請使用 Kerberos 驗證通訊協定,以數位方式簽署 LDAP 伺服器的所有 LDAP 流量。
CERT_LDAP_STORE_UNBIND_FLAG
使用此旗標搭配CERT_LDAP_STORE_OPENED_FLAG旗標,在關閉 存放 區時,LDAP 會話會解除系結。 當存放區關閉時,系統會使用 ldap_unbind 函式來解除LDAP會話的系結。

[in] pvPara

32 位值,可包含此函式的其他資訊。 此參數的內容取決於 lpszStoreProvider 和其他參數的值。

傳回值

如果函式成功,函式會傳回 證書存儲的句柄。 當您完成使用存放區時,請呼叫 CertCloseStore 函式來釋放句柄。

如果函式失敗,它會傳回 NULL。 如需擴充錯誤資訊,請呼叫 GetLastError

注意CreateFileReadFile 或登錄錯誤可能會傳播,並傳回錯誤碼。 CertOpenStore 有自己的單一錯誤碼,ERROR_FILE_NOT_FOUND碼,表示函式找不到 lpszStoreProvider 參數指定的提供者。
 

備註

系統存放區是由一或多個實體同層級存放區組成的集合。 每個系統存放區都有預先定義的實體同層級存放區。 在CERT_SYSTEM_STORE_CURRENT_USER開啟 「My」 之類的系統存放區之後, 會呼叫 CertOpenStore 來開啟系統存放區集合中的所有實體存放區。 每個實體存放區都會使用 CertAddStoreToCollection 函式新增至系統存放區集合。 這些實體存放區中的所有憑證、CRL 和 CCL 都可透過邏輯系統存放區集合取得。

注意 憑證內容的順序可能不會保留在存放區內。 若要存取特定憑證,您必須逐一查看存放區中的憑證。
 

您可以從遠端開啟下列系統存放區位置:

  • CERT_SYSTEM_STORE_LOCAL_MACHINE
  • CERT_SYSTEM_STORE_LOCAL_MACHINE_GROUP_POLICY
  • CERT_SYSTEM_STORE_SERVICES
  • CERT_SYSTEM_STORE_USERS

系統會在傳遞至 pvPara 的字串中,加上計算機名稱的前置詞,從遠端開啟系統存放區位置。 遠端系統存放區名稱的範例包括:

  • ComputerName\CA
  • \\ComputerName\CA
  • ComputerName\ServiceName\Trust
  • \\ComputerName\ServiceName\Trust

如需系統存放區的詳細資訊,請參閱 系統存放區位置

如需自動移轉之存放區的詳細資訊,請參閱 證書存儲移轉。

範例

下列範例顯示開啟不同存放區提供者類型的數個證書存儲。 此範例使用 CreateMyDACL 函式,其定義於建立 DACL 主題中,以確保開啟的檔案是以適當的 DACL 建立。 如需開啟其他存放區提供者類型的更多範例,請參閱 開啟證書存儲的 C 程式代碼範例

//-------------------------------------------------------------------
// Open a system store, in this case, the My store.

HCERTSTORE hSysStore = NULL;
if(hSysStore = CertOpenStore(
   CERT_STORE_PROV_SYSTEM,          // The store provider type
   0,                               // The encoding type is
                                    // not needed
   NULL,                            // Use the default HCRYPTPROV
   CERT_SYSTEM_STORE_CURRENT_USER,  // Set the store location in a
                                    // registry location
   L"MY"                            // The store name as a Unicode 
                                    // string
   ))
{
    printf("The system store was created successfully.\n");
}
else
{
    printf("An error occurred during creation "
        "of the system store!\n");
    exit(1);
}

// Other common system stores include "Root", "Trust", and "Ca".


//-------------------------------------------------------------------
// Open a memory store. 

HCERTSTORE hMemStore = NULL;
if(hMemStore = CertOpenStore(
   CERT_STORE_PROV_MEMORY,   // The memory provider type
   0,                        // The encoding type is not needed
   NULL,                     // Use the default HCRYPTPROV
   0,                        // Accept the default dwFlags
   NULL                      // pvPara is not used
   ))
{
    printf("The memory store was created successfully.\n");
}
else
{
    printf("An error occurred during creation "
        "of the memory store!\n");
    exit(1);
}

//-------------------------------------------------------------------
// Open a read-only store from disk.

HANDLE       hFile = NULL;
HCERTSTORE   hFileStore = NULL;
LPCSTR       pszFileName = "TestStor2.sto";
SECURITY_ATTRIBUTES  sa;        // For DACL

// Create a DACL to use when opening the file.
sa.nLength = sizeof(SECURITY_ATTRIBUTES);
sa.bInheritHandle = FALSE;  

// Call function to set the DACL. The DACL is set in the 
// SECURITY_ATTRIBUTES lpSecurityDescriptor member.
if (!CreateMyDACL(&sa))
{
     // Error encountered; generate message and exit.
     printf("Failed CreateMyDACL.\n");
        exit(1);
}

// Obtain the file handle of an existing file.
if (hFile = CreateFile(
     pszFileName,                  // The file name
     GENERIC_READ|GENERIC_WRITE,   // Access mode: Read from and
                                   // write to this file
     0,                            // Share mode
     &sa,                          // Uses the DACL created 
                                   // previously 
     OPEN_ALWAYS,                  // How to create
     FILE_ATTRIBUTE_NORMAL,        // File attributes
     NULL))                        // Template
{
    printf("The file was opened successfully.\n");
}
else
{
    printf("An error occurred during opening of the file!\n");
    exit(1);
}

//-------------------------------------------------------------------
//  This file can contain data before the store itself.
//  At this point, read and use data in the open file that precedes
//  the serialized certificate store data. 
//  To open the certificate store, the file pointer must
//  be placed at the beginning of the certificate store data.

//-------------------------------------------------------------------
//  Open the store.

if(hFileStore = CertOpenStore(
    CERT_STORE_PROV_FILE,     // Load certificates from a file
    0,                        // Encoding type not used
    NULL,                     // Use the default HCRYPTPROV
    CERT_STORE_READONLY_FLAG, // Read-only store
    hFile                     // The handle for the open file 
                              // that is the source of the 
                              // certificates
    ))
{
    printf("The file store was created successfully.\n");
}
else
{
    printf("An error occurred during creation of the file store!\n");
    exit(1);
}

//-------------------------------------------------------------------
// After processing, close the certificate stores and the file.

if(CertCloseStore(
        hSysStore, 
        CERT_CLOSE_STORE_CHECK_FLAG))
{
    printf("The system store was closed successfully.\n");
}
else
{
    printf("An error occurred during closing of the "
        "system store.\n");
}

if(CertCloseStore(
        hMemStore, 
        CERT_CLOSE_STORE_CHECK_FLAG))
{
    printf("The memory store was closed successfully.\n");
}
else
{
    printf("An error occurred during closing of the "
        "memory store.\n");
}

if(CertCloseStore(
        hFileStore, 
        CERT_CLOSE_STORE_CHECK_FLAG))
{
    printf("The file store was closed successfully.\n");
}
else
{
    printf("An error occurred during closing of the file store.\n");
}

if(CloseHandle(hFile))
{
    printf("The file was closed successfully.\n");
}
else
{
    printf("An error occurred during closing of the file.\n");
}

規格需求

需求
最低支援的用戶端 Windows XP [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 wincrypt.h
程式庫 Crypt32.lib
Dll Crypt32.dll

另請參閱

CERT_SYSTEM_STORE_RELOCATE_PARA

CertCloseStore

CertSaveStore

證書存儲函式